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Develop faster. Compile 
faster. Debug faster. Realize 
your Java™ dreams faster. 


# Symantec, the creator of 

aaa " the first full-featured Java 

development environment, now unleashes | 

the first Rapid Application Development 
environment for Java developers: 


7 ™M 
. 


Symantec Visual Caf 


Visual Café comes complete with an | 
extensible component library with all of the 
building blocks you need for your application. 


Simply drag and drop a component 
onto a form. Our Interaction Wizard 
lets you visually specify all the actions 
and events. And then Visual Café 
automatically generates the Java 
code for you. 


Thanks to our exclusive two-way 
programming you can add or modify 
the code at the source level, too. 


So you'll be whipping out those 
application prototypes at speeds 


you can only dream of now. cone 
an Windows’95 
Imagine building all of your forms 


visually. Or building your entire user interface 
without writing one single line of code! 


As an added bonus, Symantec's Just In 
Time compiler (JIT) (included in Netscape's 
upcoming Navigator™) runs your Java 
applications faster than any other browser 
or Java virtual machine on the planet. 


90 get your hands on the hottest new 
development tool for Java right away. 


Buy Visual Café today for just $199* and 
receive a $40.00 mail-in rebate. Make your 
purchase online at cafe.symantec.com. 
Or pick up a copy at Fry’s, MicroCenter, 
CompUSA or Egghead. For more info, call 
1-800-453-1059 ext. 9H31. 













Eddy Award Winner for Best New Developer Tool 
— MacUser Editors Choice Awards, 1993 


“A distinct improvement over ResEdit.” 
— MacTech /MacTutor 


“Resorcerer’s data template system is amazing!” 
— Bill Goodman, author of Compact Pro 


*Nuke ResEdit! Resorcerer is mission-critical for us.” 
— Dave Winer, Userland Frontier 


“The color pixel editors are wonderful! A work of art!” 
— Dave Winzler, author of Microseeds Redux 


“Every Macintosh developer should own a copy of Resorcerer.” 
— Leonard Rosenthol, Aladdin Systems 


“Resorcerer will pay for itself many times over in saved time and effort.” 
— MacUser review 


“The template that disassembles ‘PICT’s is awesome!” 
— Bill Steinberg, author of Pyro! and PBTools 


“Resorcerer proved indispensible in its own creation!” 
— Doug McKenna, author of Resorcerer 


“..a wealth of time-saving tools.” 
MacUser Review, Dec. 1992 


RESORCERER 


The Resource Editor for the Macintosh Wizard 





Version 1.2.4 


ORDERING INFO e New ‘cicn’, ‘ppat’, ‘crsr’, ‘acur’, ‘pltt’, ‘clut’ editors 
¢ Powerful icon family editing (all 9 icon types) 
_ ¢ Color pixel anti-aliasing, dithering, and lots more 
¢ Complete ‘PICT’ disassembly and reassembly 
New 1.2 Features: * Resource sorting; ROM resource browsing 
¢ 120 template field parsing types now supported 
e New insertion & deletion template field types 
e Text-only ‘PICT’ resources 


e Lots of improvements throughout 


Needs: 2Mac Plus, 2 Sys 4.2, IMB 
Likes: 2Mac Plus, 2 Sys 7.0,2MB 
32-bit clean, AU/X compatible — 


Price: $256 (decimal) 
(Educational, quantity, or 
other discounts available) _ e Easier, faster, more Mac-like, and more productive than ResEdit 


¢ Safer memory-based, not disk-file-based, design and operation 


Includes: 500 page manual : 
60-day Money-Back Guarantee © 
Domestic UPS ground shipping 


Payment: Check, PO's, or Visa/MC 


Extras (call us): 
COD, FedEx, UPS Blue/Red, | 
International Shipping ~_ 


Downloadable Demos/Updaters: 


AppleLink: Software Sampler _ 
AOL: Software Libs/Development 
CompuServe: MACDEV/Tools — 
or call us. 





e All file information and common commands in one easy-to-use window 
¢ Compares resource files, and even edits your data forks as well 

e Visible, accumulating, editable scrap 

¢ Searches and opens/marks/selects resources by text content 

¢ Makes global resource ID or type changes easily and safely 

¢ Builds resource files from simple Rez-like scripts 

¢ Most editors DeRez directly to the clipboard 

e All graphic editors support screen-copying or partial screen-copying 
¢ Hot-linking Value Converter for editing 32 bits in a dozen formats 

¢ Its own 32-bit List Mgr can open and edit very large data structures 
¢ Templates can pre- and post-process any arbitrary data structure 

¢ Includes nearly 200 templates for common system resources 

¢ TMPLs for Installer, MacApp, QT, Help, AppleEvent, OCE, GX, etc. 
¢ Full integrated support for editing color dialogs and menus 

¢ Try out balloons, ‘ictb’s, lists and popups, even create C source code 
¢ Integrated single-window Hex/Code Editor, with patching, searching 
¢ Editors for cursors, versions, pictures, bundles, and lots more 

¢ Well-designed, helpful developer tools being added all the time 

¢ Relied on by thousands of Macintosh developers around the world 


MATHEMASSTHETICS, INC. 


P.O. Box 298 © Boulder * CO ¢ 80306-0298 © USA 


Phone: (303) 440-0707 © Fax: (303) 440-0504 


AppleLink/AmericaOnline: RESORCERER © Internet: resorcerer@aol.com 














How To Communicate With Us 


In this electronic age, the art of communication 
has become both easier and more complicated. 
Is it any surprise that we prefer e-mail? 


If you have any questions, feel free to call us at 


805/494-9797 or fax us at 805/494-9798. 


If you would like a subscription or need 
customer service, feel free to contact Developer 


Depot Customer Service at 
800-MACDEV-1 
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articles, ask us for our writer’s 
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By Eric Gundrum 








NEXT OS FOR MACINTOSH 

Apple has finally set the direction for the development of a 
modern operating system. Whether they made the right decision 
or not, at least the OS engineers now know what to work on; 
$400 million ensures it won’t be changing anytime soon. That 
will leave a little less time for Marathon, but we should start 
seeing some hard results by this summer. 

As always, many people are second guessing Apple’s 
decision to acquire NeXT and use their OS as the basis for a 
modern OS for Macintosh. Looking at the facts I’m sure you will 
see that Apple and NeXT are a good fit. 


NEXTSTEP, A COMPLETE OS 

NeXTSTEP is a solid and complete OS with several years in 
the field. It contains all the basic tools, most critical to getting a 
job done, including a very strong imaging model. Add the 
OPENSTEP framework, Interface Builder and other development 
tools, and we have an environment where writing and running 
applications is just plain fun. 

Sure, it doesn’t have the Macintosh look and feel. It has icons 
larger than Mount Rushmore. It lacks the friendly anchor of a menu 
bar across the top of the screen. These things can change, and you 
can bet Apple will change them. Apple promises to provide us a new 
OS with a Macintosh face we'll recognize as Macintosh. 

The worst criticism I’ve heard of the NeXT acquisition is that 
their OS is just plain old. Not as old as the MacOS, mind you, but 
ten years is a long time in our industry. Keep in mind that 
NeXTSTEP was state-of-the-art when it was first released. It was 
built on a Mach kernel using something like the component 
software model Apple has been touting for years as the savior of 
their OS strategy. The object oriented nature of the OS allows 
much easier replacement of any component deemed to long in the 
tooth for the 90s. 

You can bet Apple will be changing some of those 
components, too. There are aspects of the NeXT user interface that 
are just plain wrong, and there are some important pieces missing 
from the foundation. They must also add the missing MacOS 
technologies: OpenDoc, OSA, QuickTime Media Layer, and others. 
Unfortunately, it seems QuickDraw QX will be a casualty. 


OBJECTIVE-C AND JAVA 
Another interesting side affect of Apple’s OS plans is the 
revitalization of Objective-C. When NeXT was starting out C++ was 
not very popular. (This was before ANSI-C existed.) NeXT chose 
Objective-C as the development language of choice for their OS 
and closely tied software development for the NeXT platform to the 
language. (Sounds a bit like Pascal in the early days of the Mac, 


4 VIEWPOINT 


doesn’t it?) Unfortunately for them no one took much notice. 
Objective-C seemed to disappear from all but NeXT machines. 
However, NeXT built a very compelling set of development tools 
around this language, including the OPENSTEP framework. 

These tools are so compelling that some developers create 
their software on the NeXT, then port to other platforms for the 
final release. In fact, Objective-C worked so well, the Java 
engineers at Sun borrowed a few tricks from it. It turns out that 
the runtime model for Java is very close to that of Objective-C. 
NeXT took advantage of this and provides Java access to many of 
the modules of the OPENSTEP framework. This makes Java the 
second language of choice for OPENSTEP development. Apple 
insists Java will be even more important for development on the 
Mac; so important, OpenDoc is being rewritten in Java. 


COMPATIBILITY OR BUST 

There are still many unanswered questions about the details 
of what kind of compatibility for existing software Apple will offer 
in their modern OS for Macintosh (code named Rhapsody). 
Apple’s official word at Expo was to provide a compatibility box 
(blue box) that will run a complete MacOS 7.7 in a separate 
window, but on top of the modern OS kernel. Any software that 
does not directly access hardware, including many system 
extensions, should work in the blue box. Unfortunately access 
across the blue box boundary is limited to copy and paste. 

To make matters worse, there is no way to build an application 
for the modern OS and have it run under System 7. The APIs are so 
different Apple had no plans to provide new APIs to build modern 
applications that will run under both operating systems. This has 
upset a few developers. Given a little more time Apple or the 
community my find a way to help us bridge our apps across both 
operating systems. It is not a trivial problem to solve. 


In Tuts ISsuE 

There is certainly much to read in order to learn the basics of 
OPENSTEP and Objective-C. We offer two articles to help you get 
started in this issue, with more on the way. Much more information 
about OPENSTEP and Objective-C is available on NeXT’s web site. 
Apple’s site offers plenty of information about their two year OS plan. 
Additionally, Tenon was quick to the punch with adding Objective-C 
support to CodeBuilder. Be sure to check it out. 

Also in this issue are articles about several alternate 
programming environments. If you don’t like C or C++, you have 
plenty alternatives to choose from. There are many more 
programming options for Macintosh than we had space to print, 
but a little bit of research should turn up development tools for 
your personal favorite. i 
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MacHASP Packs 


More Into Less. 

Based on state-of-the-art ASIC technology, 
MacHASP packs the industry’s most 
advanced security, compatibility and 
flexibility into a compact and end-user- 
friendly dongle. 


Grow With Aladdin! 


The fastest growing company 
in the industry, with over 4 
million keys sold to 20 
thousand developers 
worldwide, Aladdin is setting 
the standard for software security today. 









HASP No.1 
A recent test conducted by the National 
Software Testing Labs", the world’s foremost 
independent lab, compared the flagship PC 
products of leading software protection 
vendors. The result? HASP was rated the clear 
overall winner - and number one in all the 
major comparison categories. For a full copy 
of the NSTL report, contact your local 
HASP distributor. 


North America Aladdin Knowledge Systems Inc. ‘el: (800) 223 4277, 212-564 5678, Fax: 212-564 3377, E-mail: hasp.sales@us.aks.com 


MacHASP 


PROTECTS 
MORE. *. 


These days, more and more developers are choosing to protect their software against 
piracy. They’ re protecting more products, on more platforms, with better protection — 
and selling more as a result. 


And more of these developers are protecting with MacHASP. Why? 
Because MacHASP offers more security, more reliability and more 
features than any other product on the market. Only MacHASP offers 
capabilities such as network support, anti-debugging envelope 
protection, and secure remote activation and updating. 













MacHASP supports the most advanced platforms, including all 
versions of MacOS and Power Mac — as well as AppleTalk 
networks. And because Aladdin is a licensed Apple Partner, 
MacHASP guarantees full, transparent compatibility 

with the ADB standard. 


To learn more about how you can protect 
better — and sell more — call now to order 
your MacHASP Developer’s Kit. 


The MacHASP Developer's Kit contains 
everything you need to protect your 
software today! 


1-800-223-4277 


aks.com 
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By Dave Mark 








Last month’s Getting Started column 
introduced the ShapeWorld applet. The 
initial version of ShapeWorld featured four 
classes: The ShapeWorld class extends the 
Applet class and creates and controls all the 
applet objects. The ShapeCanvas class 
extends the Canvas class and implements 
the canvas we'll do all our drawing in. The 
Shape class is designed to be extended and 
provides the basic functions for 
implementing a shape. The RectShape class 
extends Shape and overrides the Shape 
classes’ abstract draw() method to draw a 
rectangular shape. 

Why divide the shapes into two 
separate classes? After all, we could have 
just done the drawing in the Shape class. 
However, that is what this month’s column 
is all about. We are going to add a second 
Shape subclass to our applet, along with 
some code that lets you drag your shapes 
around in the ShapeCanvas. 


THE SHAPEWORLD PROJECT 


Here’s the source code to this month’s 
applet. For the most part, we’ve added 
code to last month’s project with only a 
few lines changed (mostly to change the 
way highlighting works — more on this in 
a moment). 


import java.awt.*; 
import java.util.*; 


abstract class Shape 


boolean highlighted; 
ShapeCanvas shapeCanvas; 
int shapeX, shapeY, shapeWidth, 
shapeHeight; 
Rectangle boundsRect; 
Shape( ShapeCanvas canv, int x, int y, 
int width, int height ) 
{ 
shapeCanva 


S anv; 
highlighted 


Cc 
false: 
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An Expanded ShapeWorld Applet 





shapeX = x; 

shapeY = y; 
shapeWidth = width; 
shapeHeight = height; 


boundsRect = new Rectangle( x, y, width, height ); 
} 


abstract public void draw( Graphics g ); 
public void erase( Graphics g ) 


g.clearRect( shapeX, shapeY, shapeWidth, shapeHeight ); 
} 


public void setHighlight( boolean newHighlight ) 


highlighted = newHighlight; 


public boolean isHighlighted() 
{ 

return highlighted; 
} 


public boolean isPointInShape( int x, int y ) 
( 
return boundsRect.inside( x, y ); 


public voidmoveThisMuch( int x, int y ) 
{ 
boundsRect.move( shapeX + x, shapeY + y ); 
shapeX = boundsRect.x; 
shapeY = boundsRect.y; 
shapeWidth = boundsRect.width; 
shapeHeight = boundsRect.height; 
} 


class RectShape extends Shape 


RectShape( ShapeCanvas canv, int x, int y, 
int width, int height ) 


super( canv, x, y, width, height ); 


public void draw( Graphics g ) 
( 
if ( isHighlighted() ) 


g ( Color.black ); 
g.fillRect( shapeX, shapeY, shapeWidth, shapeHeight ); 
g.setColor( Color.red ); 
g.fillRect( shapeXt2, shapeY+2, 

shapeWidth-4, shapeHeight-4 ); 


.setColor 


else 
{ 
g.setColor( Color.red ); 
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IT’S TIME TO PUT YOUR SOFTWARE INTO 
THE RIGHT HANDS. THE CONSUMERS. 


Step out of the Jurassic Age. A worldwide cyber 
phenomenon is about to crack conventional software 
marketing wide open. Can you say “opportunity”? 


YOU’LL RECEIVE PRIME SHELF SPACE 
IN A STORE THAT NEVER CLOSES. 
You want to be where your customers will see you. 
You want to be available to them on their terms, in 
their environment, on their time schedule. You want 
them primed for shopping. Primed for buying. 
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WE DELIVER. 


YOUR CUSTOMERS WILL FIND YOU. 


Fast becoming the world’s most comprehensive sojt- 
ware database—we’re free to over 80 million customers. 
There’s going to be a lot of browsing, demoing and 
deciding which software is just right for them or their 
companies. Eventually, links will transport them 
directly to their chosen software vendor. And that 
translates into very good business. We invite you to be 
there to greet them, you can bet your competitor will. 


SIGN UP TODAY: 1-888-DEMONET. 
demonetonliine.com 








© 1996 Demonet. Demonet is a 
registered trademark of Demonet, Inc. 
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: ; g.fillRect( shapeX, shapeY, shapeWidth, shapeHeight ); 
x CMANAY ats)rite(ol-\o¥rmrs| (Mm rele(-10] (0) (ars | 
: 4 : . 
6 [superior client/server application? ! 
s a 
rd A: A SUPERIOR SERVER class OvalShape extends Shape 
{ 
7 START with the RESULT? OvalShape ( soaks ieee ren x, int V¥, int width, 
‘8M most advanced client- A solid, economical, a 
side SDK on the easily deployable super( canv, x, y, width, height ): 
market: c-tree® Plus product that fits 

at $895. your needs. 
5 ¢ Complete “C” Source code ¢ Portable public void draw( Graphics g ) 
rae * ROYALTY FREE * Scalable ( LL. 

(Client Side) ¢ Exceptional Performance if ( isHighlighted() ) 
om. Multiple supported ¢ Flexible 
= protocols ¢ Easy Server distribution g.setColor( Color.black ); 
0 ¢ Fast, portable, reliable * Convenient OEM terms g.fillOval( shapeX, shapeY, shapeWidth, shapeHeight ); 
2 ¢ Powerful features like g.setColor( Color.red ); 
- transaction processing FAIRCOM g.fillOval( shapeXt2, shapeYt2, 

¢ Win95, NT, and Server shapeWidth-4, shapeHeight-4 ); 
Windows 3.1 ready } 
else 


{ 

g.setColor( Color.red ); 

g.fillOval( shapeX, shapeY, shapeWidth, shapeHeight ); 
} 


ADD a strong, 


multi-platform, 

industrial-strength 

Server that supports. 

¢ File mirroring 

e Heterogeneous networking , ‘ 

e Automatic disaster recovery mac 

e Multi-threaded design Heterogeneous 


¢ Best price/performance Tee Network 
available: from $445- $3745 


me a S DG 


class ShapeCanvas extends Canvas 
Vector shapes; 
Shape curShape; 


: : ; Point mousePosition; 
You can’t find a better client SDK with these features! 


Over sixteen years of proven reliability and performance. 


No one else supports over 30 platforms in this price range! eae ( int width, int height ) 


shapes = new Vector(); 
curShape = null; 
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c-tree Plus® FairCom® Server 


¢ Complete C Source ¢ Client/Server Model 
¢ Single/Multi User ¢ Transaction Processing 
¢ Client/Server (optional) e Requires <2MB RAM 
¢ Full ISAM functionality ¢ Online Backup 
¢ No Royalties ¢ Disaster Recovery 
e Transaction Processing ¢ Rollback - Forward 
e Fixed/Variable Length Records  e¢ Anti-Deadlock 
¢ High Speed Data/Index Resolution 
Caching ¢ Client-side "C" Source 
¢ Batch Operations e Multi-threading 
e File Mirroring e Heterogeneous networking 
¢ Multiple Contexts e File Mirroring 
¢ Unsurpassed Portability ¢ OEM/Source Available 


setBackground( Color.yellow ); 


resize( width, height ); 


public void addShape( Shape newShape ) 
{ 

shapes.addElement( newShape ); 
} 


public void paint( Graphics g ) 
{ 
for ( Enumeration e = shapes.elements(); 
e.hasMoreElements(); ) 


FOR YOUR NEXT PROJECT CALL FAIRCOM: YOU 
CAN'T FIND A BETTER HETEROGENEOUS 


CLIENT/SERVER SOLUTION! (Shape) e.nextElement () ; 


ae 3 es 
Also inquire about these FairCom products: 
d-tree™ 

r-tree® 

ODBC Driver 


»EAIRCOM 


| CORPORATION 


Since 1979 


\WWWeb Address: http://www. faircom.com/ 
S8oa0-234-818e0 


U.S.A. phone (573) 445-6833 fax (573) 445-9698 
EUROPE phone ed. 773-464 fax (035) 773-806 
sk 05 : 08 2 


public Shape findInShapeList( int x, int y ) 
( 
for ( Enumeration e = shapes.elements(); 
e.hasMoreElements(); ) 
( 
Shape s = (Shape)e.nextElement () ; 


if )(6.asPointinShape( x, y ) ) 
{ 


Le — ee — | ee — ) ee a ee — Ne 


rf 


s.draw( getGraphics() ); 


return s; 
} 
} 


CALPHA) « 


return null: 


} 
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public void update (Graphics g) 
paint (g) ; 


public boolean mouseDown( Event e, int x, int y ) 


{ 
curShape = findInShapeList( x, y ); 


if ( curShape != null ) 

{ 
curShape.setHighlight( true ); 
mousePosition = new Point( x, y ); 


return true; 


return false; 


public boolean mouseDrag( Event e, int x, int y ) 
{ 
Graphics g; 


if ( curShape != null ) 
{ 
g = getGraphics(); 


curShape.erase( g ); 


curShape.moveThisMuch( x - mousePosition.x, 
y - mousePosition.y ); 


mousePosition.x = X; 
mousePosition.y = y; 


curShape.draw( g ); 


return true; 


} 


return false; 


public boolean mouseUp( Event e, int x, int y ) 
{ 
if ( curShape != null ) 
{ 
curShape.setHighlight( false ); 
repaint (); 


return true; 


} 
return false; 


} 


public class ShapeWorld extends java.applet.Applet 
{ 

ShapeCanvas sCanvas; 

final int shapeWidth = 20; 

final int shapeHeight = 20; 


public void init() 
{ 


int z.¥s 


sCanvas = new ShapeCanvas( 440, 290 ); 
add( sCanvas ); 


Random ran = new Random(); 
Rectangle b = sCanvas.bounds() ; 


for ( int i=l; i<=10; i++ ) 
{ 


x = b.x + (int) ((float) (b.width) * ran.nextFloat() ); 


if (x > b.x + b.width - shapeWidth ) 
x -= shapeWidth; 


y = b.y + (int) ((float) (b.height) * ran.nextFloat() ); 


if (y > b.y + b-height - shapeHeight ) 
y -= shapeHeight; 
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RectShape r = new RectShape( sCanvas, x, y, 
shapeWidth, shapeHeight ); 
sCanvas.addShape( r ); 
} 


for ( int i=l; i<=10; itt ) 
{ 
x = b.x + (int) ((float) (b.width) * ran.nextFloat() ); 
if (x > b.x + b.width - shapeWidth ) 
x -= shapeWidth; 


y = b.y + (int) ((float)(b.height) * ran.nextFloat() ); 
if (y > b.y + b.-height - shapeHeight ) 
y -= shapeHeight; 


OvalShape r = new OvalShape( sCanvas, x, y, 
shapeWidth, shapeHeight ); 
sCanvas.addShape( r ); 


RUNNING THE NEW SHAPEWORLD 


Before we get to the source code differences between last 
month’s applet and this month’s applet, take a look at Figure 1, 
which shows the applet running under the Metrowerks VM. The 
figure shows the applet window with the ShapeCanvas taking up 
most of the window (shown in yellow). The Canvas shows 10 
RectShapes and 10 OvalShapes. 

Notice that only one shape is highlighted. In last month’s 
applet, we toggled highlighting for a shape on and off again with 
each click. Since we added dragging this month, I wanted to try a 
slightly different approach to highlighting. Now, highlighting turns 
on when a drag starts and turns off when the drag ends. This isn’t 
necessarily correct for all applications, but the changes needed to 
implement this approach are worth understanding. 

Notice also that when one shape drags over another, the 
underlying shape is erased to the background color and is not 
restored until the drag ends. Take some time to see why this 
happens. How could you change this code so that “dragged- 
over” shapes are not erased by the drag? 


Applet Viewer: ShapeWorld.class 





Figure 1. The new ShapeWorld applet 
running under the Metrowerks VM. 
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WHAT SOURCE CODE WAS ADDED THIS MONTH? 


The first change made to last month’s code is the addition of 2 
new methods to the Shape class. erase() calls the Graphics method 
clearRect() to erase the current Shape to the background color. As 
you might guess, erase() is a key part of the erase/redraw cycle we 
use when dragging a shape. This is definitely a bare-bones 
approach to drag animation. Can you come up with some 
alternatives? 


public void erase( Graphics g ) 
{ 

g.clearRect( shapeX, shapeY, shapeWidth, shapeHeight ); 
} 


moveThisMuch() takes an x and a y offset and moves the shape 
that many pixels left or right and up or down. Just a reminder: since 
we maintain both a Rectangle (boundsRect) and a set of individual 
x, y, width, and height variables, we'll need to update both. On 
reflection, if I had this to do over again, I probably would have 
picked one or the other but not both, just to avoid the confusion that 
comes with having to keep both in sync. 


public voidmoveThisMuch( int x, int y ) 
{ 
boundsRect.move( shapeX + x, shapeY t+ y ); 
shapeX = boundsRect.x; : 
shapeY = boundsRect.y; 
shapeWidth = boundsRect.width; 
shapeHeight = boundsRect.height; 


Next, we added a new Shape subclass. OvalShape is almost 
identical to RectShape, calling fillOval() instead of fillRect(). 
Though the OvalShapes may look like circles, they are indeed 
ovals. Try changing the bounding rectangle used to create them 
and see for yourself. 


class OvalShape extends Shape 
{ 
OvalShape( ShapeCanvas canv, int x, int y, int width, 
int height ) 
super( canv, x, y, width, height ); 
} 


public void draw( Graphics g ) 
( 

if ( isHighlighted() ) 

( 


g.setColor( Color.black ); 
g.fillOval( shapeX, shapeY, shapeWidth, shapeHeight ); 
g.setColor( Color.red ); 
g.fillOval( shapeXt+2, shapeY+2, 
shapeWidth-4, shapeHeight-4 ); 
} 
else 
{ 
g.setColor( Color.red ); 
g.fillOval( shapeX, shapeY, shapeWidth, shapeHeight ); 
} 
} 


Next, the variable mousePosition was added to the 
ShapeCanvas class. mousePosition is used to track the mouse’s 
position when the drag started and as it proceeds. 
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class ShapeCanvas extends Canvas 
( 

Vector shapes; 

Shape curShape; 

Point mousePosition; 


To implement the drag, we had to make a few changes. 
First, we added some code to the mouseDown() method to 
highlight the shape and store away the current mouse position. 

public boolean mouseDown( Event e, int x, int y ) 

curShape = findInShapeList( x, y ); 

if ( curShape != null ) 

{ 


curShape.setHighlight( true ); 
mousePosition = new Point( x, y ); 


return true; 


return false; 


While the drag is happening, we'll get repeated calls to 
mouseDrag(). Assuming the drag was inside a shape, we first 
erase the shape, then move it, then redraw it. 

public boolean mouseDrag( Event e, int x, int y ) 

Graphics g; 

if ( curShape != null ) 

{ 

g = getGraphics(); 
curShape.erase( g ); 


curShape.moveThisMuch( x 
y - mousePosition.y ); 


- mousePosition.x, 


mousePosition.x = x; 
mousePosition.y = y; 


curShape.draw( g ); 


return true; 


return false: 


When the mouse button is released, the mouseUp() method is 
called. When this happens, we unhighlight the shape and redraw all 
the shapes. Note the difference between repaint() and draw(). 


public boolean mouseUp( Event e, int x, int y ) 
{ 
if ( curShape != null ) 


curShape.setHighlight( false ); 
repaint (); 


sreturn true; 


} 


return false; 
} 
} 
Finally, we'll add some code to the ShapeWorld class to 
create 10 of our new OvalShapes. This code is the same as that 
used to create the RectShapes. 
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for ( int i=l; i<=10; it ) 
{ 


= b.x + (int) ((float) (b.width) * ran.nextFloat() ); 
(x > b.x + b.width - shapeWidth ) 
x -= shapeWidth; 


ITI 


fi 


= b.y + (int) ((float)(b. height) * ran.nextFloat() ); 
if (y > b.y + b.height - shapeHeight ) 
y -= shapeHeight; 


OvalShape r = new OvalShape( sCanvas, x, y, 
shapeWidth, shapeHeight ); 
sCanvas.addShape( r ); 
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Tutt NEXT MONTH... 


Take some time to look over this code. Can you improve it? 
What happens if you replace the erase() call with a call to 
repaint()? Can you improve the performance of the code? How 
would you add a graphical background to the Canvas? Can you 
add a pair of buttons to the interface, one to create a new 
RectShape and one to create a new OvalShape at a random 
location in the Canvas? See you next month. 
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MCL in the Motorola Chip Factory 





Creating a “fab” solution in 
a web browser using 
Macintosh Common Lisp 
and MIT’s CL-HTTP server 


MCL CONDUCTS AN ORCHESTRA 


Macintosh Common Lisp (MCL) is in 
active use in projects at several universities 
and corporations worldwide. One of these 
is Orchestra, a Motorola project to develop 
automated tools for scheduling wafer fabs 
(factories in which semiconductor wafers 
are fabricated) in their Semiconductor 
Products Sector. 

When the Orchestra implementors 
decided to improve the user interface for 
the “Fab Browser” part of the system by 
putting it on the web, they found a simple 
and elegant solution using only a hundred 
additional lines of MCL code and CL-HTTP 
[Mallery 94], a Lisp program from MIT 
which I describe below. A description of 
that solution, based on a presentation by 
Byron Davies at the 1996 Dynamic Objects 
Workshop in Boston, appears later in the 
article. 


AN OVERVIEW OF Lisp 
Lisp differs from traditional languages 
such as C and Pascal in several ways. Lisp 
variables can hold values of any type, and 
there are quite a few available: strings, 
symbols, lists, vectors, structures, hash 


tables, integers, floats, ratios, and packages to name but a few. Lisp 
functions can be created and used without requiring an edit- 
compile-link cycle; they can be generated by Lisp code and passed 
as arguments to other functions; and they can “close over” data 
values in sophisticated ways. A macro facility allows for compile- 
time manipulation and generation of Lisp expressions, and a 
package system segregates program symbols (variable and 
function names) into separate namespaces to ease the integration 
of programs and development of large systems. There are 
powerful output formatting functions, a stream mechanism, and 
comprehensive mathematics functions and data types, including 
bignums (unlimited-size integers), complex numbers, and ratios. 
There are high-level control structures for dealing with non-local 
exits, and an object-oriented exception mechanism. And of course, 
there is CLOS (Common Lisp Object System), an extensible object- 
oriented framework that’s particularly useful for implementing 
other object-oriented frameworks, if you're into that sort of thing. 
CLOS objects are instances of classes, and they are operated on 
by functions called methods. 

What's “common” about Common Lisp is that it’s a widely- 
used standard for the language, and code or portions of code that 
are compliant to the standard are able to run on platforms 
implementing a compliant Common Lisp. CL-HTTP is an example 
of a large Common Lisp program which runs on many platforms. 


WuatT MCL BrINGs TO THE PARTY 

MCL is the Macintosh implementation of Common Lisp. MCL 
was originally developed at Coral Software, then became an 
Apple product when that company was acquired by Apple, and 
is now a product of Digitool, Inc. Over the last decade or so it 
has kept evolving — the current version, MCL 4.0, generates 
native PowerPC machine code. MCL was used at Apple as the 
host environment for the Apple Dylan and SK8 projects. 

Besides being true to the standard embodied in [Steele 90] 
(commonly referred to as CLtL2), MCL provides a rich development 
environment based on the Macintosh user interface, and several 





Stephen L. Hain is Software Engineering Manager at Digitool, Inc., the makers of Macintosh Common Lisp, and was a founding 
member of Coral Software, Inc. He can be reached at slh@digitool.com. Besides hacking away on various MCL projects, he’s 
currently engaged in a vicious battle to reclaim his initials from the Small Luxury Hotels of the World organization. 
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useful extensions to the standard. Typically, the user interacts with 
MCL through one or more listener windows, specialized text 
editors that evaluate Lisp forms that are typed or pasted in, display 
their results, and maintain a history of the interactions. Files are 
edited and displayed in Fred windows (Fred Resembles Emacs 
Deliberately!) and, like other Emacs text editors, Fred is extensible 
and programmable. 

MCL supports both low-level and high-level Toolbox 
interfaces. You can access the Toolbox most directly using the 
supplied interfaces, which define the constants, records, and 
routine (“trap”) calls we've all come to know and love. Object files 
and shared libraries can be dynamically linked to an MCL 
program, and the interfaces to them are defined in a similar 
manner. In general, it’s better to use the high-level interfaces to 
access the Toolbox. These interfaces include the menu, window, 
and dialog classes and methods, the file system functions and file 
streams, as well as a host of others (QuickDraw, MacTCP, serial 
streams, etc.) With these, a bug in your code will likely lead to a 
Lisp error instead of a crash into the debugger. 

Built-in development tools include a window-based 
graphical data inspector; a stack-backtrace window which 
displays program execution frames, allows frame values to be 
changed, and let’s you restart execution from any frame; facilities 
for quickly finding the definition(s) or users of a selected 
variable, function, or method; a programmable trace facility for 
tracing function calls, also accessible via dialog; an advise facility 
for modifying the behavior of functions; and a step facility for 
single-stepping through Lisp expressions. 

The MCL development environment makes use of multiple 
processes (threads), as can MCL programs. Processes allow 
different pieces of Lisp code to run concurrently. Details of MCL’s 
processes can be found in the MCL Reference Manual. Some of 
the many additional library and example modules that come with 
MCL are a graphical class grapher, WOOD (an object-oriented 
database), and even a turtle-graphics package. 


r 





é File Fdit lisp Tools Windows 6:16 PM (& 










Get info 


window-close 


‘Specializers:/~| 


Queue [sone] 













(#<MENU-ITEM “News’> #<MENU-ITEM “Op 
Ea 


¢#<MENU-ITEM “New"> #<MENU-ITEM “Open..."> ®<MENU- ITEM] 
iType: CONS 
Class: *<BUILT-IN-CLASS CONS> 



























{Normal List 
—) |Length: 18 















Package: _ 0: #<MENU-ITEM "New"> 
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> Error: Undefined function FOO called with arguments ©> 

> While executing: “Unknown” 
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> If continued: Retry applying FOO to NIL. 

See the Restarts... menu item for further choices. 

1 > 


. 






Figure 1. MCL Listener, Get Info, and Inspector windows. 


MARCH 1997 @ MACTECHMAGAZINE 


Figures 1 and 2 show several different MCL tools and 
windows in action. In figure 1 there is a listener, currently in a 
debugging break loop; a Get Info window displaying all of the 
callers of the window-close function; and several Inspector 
windows displaying information about the installed menus and 
menu items. 

In Figure 2 there is a stack-backtrace window (associated with 
the listener process that is in the break loop); a Processes window 
displaying the status of all processes; and a Fred window displaying 
one of the example files (in two viewing panes). 
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Cdefmethod set 
(setf (slot-value self ‘node-position) ¢ 
(slot-value self ‘node-center> nil 





(defmethod set-node-size (¢self node? h Sop 9 
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Cdefun graph-init ¢node> 
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Processes 


i: 


HTTP Process 9 Idle 0 3. 15h 0.0 
HTTP Process 8 Idle 0 3. 15h 0.0 
HTTP Process 7 Idle 0 3. 15h 0.0 
HTTP Process 6 Idle 0 3. 15h 0.0 
ra eeag HTTP Process 5 Listen 0 3. 15h 0.0 
HTTP Process 4 Listen 0 3.15h 0.0 
HTTP Process 3 Listen 0 3. 15h 0.0 
HTTP Process 2 Listen 0 3. 15h 0.0 
HTTP Process 1 Listen 0 3. 15h 0.0 
HTTP-Common-F i |e-Log-80-Daemon Log Wait 0 3. 15h 0.0 
Daily Server Tasks Timer 0 5.04h 0.0 
Initial Suspended 1 0.00s 99.3 









Figure 2. MCL Stack Backtrace, Processes, 
and multi-paned Fred windows. 


There is not enough room here to go into all of the features 
and tools in the MCL development environment; more 
information on them can be found in the “Getting Started with 
Macintosh Common Lisp” manual (available on-line at 
<http://www.digitool.com/mcl-getting-started.html>) and in [Parker 95]. 


UNDER THE HooD 

The MCL program environment consists of a standard 
Macintosh heap, containing pointers, handles, resources, and the 
like, and a Lisp heap, containing Lisp data, including the 
functions of the development system itself and any user code. In 
addition, MCL 4.0 on the PowerPC makes use of shared libraries 
to separate various parts of the program. Once code is loaded 
into MCL, a new image (MCL application) can be created with a 
simple Lisp function call (see listing 1). 


Listing 1: Loading your stuff and saving an MCL image 


: load all source files in a folder: 

(loop for file in (directory “HD:sources:*.lisp”) do (load 
file)) 

; save out a new image: 

(save-application “MCL + My Stuff”) 
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Forms and functions “evaluated” from a Listener or Fred 
window are usually first compiled automatically by an 
incremental compiler, and then run as native code. Lisp source 
files can be compiled into object files which then load very 
quickly into MCL. There are two garbage collectors to pick from 
in MCL: the “mark/sweep” collector, which runs when memory 
has filled up, displaying a GC cursor as it pauses the program to 
do its job; and the ephemeral garbage collector, which 
operates in the background, cleaning up unused data as a 
program runs, rarely Gif ever) causing a pause. Every listener 
window you create has its own process, so you can start some 
Lisp code running and continue to work with the MCL 
environment. There is a separate process running that handles 
events (mouse clicks, menu selections, key presses, Apple 
Events, etc.); should an error occur in that process — for 
example, in a function you’ve defined that is called from a 
menu item — all is not lost! A new, stand-in event process is 


Lisp source files can be compiled into object 
files which then load very quickly into MCL. 


created so that life can go on while you debug the problem. 
The latest versions of MCL can even grow the stacks of 
processes that use them up. 


Wuat (Goon) Is THis THING CALLED Lisp? 
There are many different reasons why Lisp or MCL is ideal 
for some tasks; here are a few of my favorites: 

e The dynamic environment. You can add and change 
functions quickly, and have access to the program you're 
working on while you’re in the development environment. 
Or you can think of it as having access to the entire 
development environment while your program is running. 
Might you wonder if changing a program while it’s running 
isn’t asking for a trip to MacsBug? Well... 

e Safety. If you stick to the high-level interfaces and supplied 
mechanisms, you're less likely to crash than to cause Lisp 
errors, which are handled more gracefully. Because Lisp is 
weakly typed (variables can hold values of any type), it 
spends some of its time checking for valid data before 
passing it down to the inflexible operating system routines 
below. (Declarations can be added to a Lisp program to 
speed it up by bypassing some of the type-checking, trading 
some safety for increased speed.) 

e Elegance. Whatever you’re programming style, you can’t 
beat Lisp (well, I can’t) for giving you so many facilities for 
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writing clear and well-organized code. Macros, packages, 
and CLOS come into play here, as well as the exception 
mechanism and a wealth of control structures. (See listing 2) 


Listing 2: Defining and using a macro that uses 
unwind-protect 


: Define a macro named with-locked-handle. 
(defmacro with-locked-handle (handle lisp-form) 
*(progn ; just groups the following forms together 
(lock-handle ,handle) ; lock the handle 
(unwind-protect ensure that unlock-handle is called, even if 
; lisp-form “throws out” to a higher frame 
lisp-form ; this “expands” to the code in the macro call 
(unlock-handle ,handle)))) 


; Define a function that uses the with-locked-handle macro. 

; (Assume that dereference dereferences a handle to obtain a pointer, and 

; that deposit-bytes deposits bytes from a list into memory.) 

(defun fill-handle (a-handle list-of-bytes) 

(with-locked-handle a-handle 
(deposit-bytes list-of-bytes (dereference a-handle)))) 

e Ease of debugging. The combination of the Inspector, 
function tracing and advising, Lisp breakpoints and break 
loops (Listeners created to allow debugging “paused” code), 
and having errors caught by Lisp instead of a low-level 
debugger can speed the debugging process considerably. Say 
you want to advise a function to write its arguments and 
result to a log file every time it’s called. A lot of work? Not 
really — see listing 3. When you're happy with the operation 
of the function, you unadvise it. 


Listing 3: Advising a function to log to a file 


; Make hairy-function log its arguments and result to a file. 
; with-open-file is a macro - it takes some “keyword arguments” to guide it. 
; loop is also a macro, that parses an English-like form and generates tight Lisp code. 
; ifdoes-not-exist, :create and other colon-prefixed symbols are “keywords” — symbols that 
; evaluate to themselves (unlike variables, which evaluate to the values they are bound to) 
(advise hairy-function 
(with-open-file (file-stream “home:log” 
:if-does-not-exist :create 
:if-exists :append 
:direction :output) 
(loop for argument in arglist do 
(print argument file-stream) ) 
(let ((result (:do-it))) 
; this is where hairy-function actually gets called 
(print result file-stream) 
result) ) 
:when :around) 


ABSOLUTELY FAB BROWSER 

A concise description of the “Fab Browser” component of 
Mototola’s Orchestra system appears in [Davies 1996]: 

“'.. the Fab Browser is a textual outline browser, 
implemented ... within MCL’s Fred version of Emacs. In the 
browser, an object is displayed as lines of text, each 
representing a component or attribute of the project. Some of 
the text lines represent other objects, which may in turn be 
expanded into multiline displays. ... expansions happen very 
quickly because tens of megabytes of manufacturing data are 
cached in a network of CLOS objects within the browser 
application. 


MACTECHMAGAZINE ® MARCH 1997 





Because of the large amount of data cached within it, the 
browser application runs in 70 to 100+ megabytes of memory, 
depending on the amount of historical or projected data. This 
was a significant roadblock to widespread use of the browser, 
both because of the amount of RAM needed to run such 
applications efficiently and because of problems of keeping large 
applications up to date on multiple desktops, some connected by 
modem lines. The situation demanded a client-server solution, 
but resources were not available to create either a customized 
server or a customized client. 

The goals for the web implementation were to (1) provide 
access to the same data, (2) preserve the look and feel, which had 
already demonstrated its effectiveness, (3) preserve performance, 
and (4) eliminate dependence on a heavyweight, expensive user 
platform in favor of lightweight, inexpensive client software.” 

Figure 3 shows a Fab Browser window using the original, 
Fred-based user interface. 
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Figure 3. A Fred-based Fab Browser window. 


Before getting into the implementation of the solution to the 
problem, a little bit about CL-HTTP is in order. 


A CoMMON Lisp WEB SERVER 

CL-HTTP is a full-featured HTTP server developed at the 
MIT Artificial Intelligence Laboratory. It is written in Common 
Lisp, is available for several Lisp platforms, comes with full 
source code, and is freely available. CL-HTTP is, according to the 
on-line documentation for the server, 

“implemented in Common LISP... in order to facilitate 
exploratory programming in the interactive hypermedia domain 
and to provide access to complex research systems over the 
Web. The general motivation for developing this server was to 
provide a computational tool that would strengthen the link 
between the artificial intelligence researchers and the distributed 
hypermedia community. As the amount of information available 
over the World-Wide Web grows, it will become increasingly 
necessary to deploy intelligent methods to store, retrieve, 
analyze, filter, and present information. At the same time, high- 
productivity programming tools employed by AI researchers will 
become increasingly relevant for testing new ideas in servers 
before incorporating them into standards-based clients. A 
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Common LISP HTTP server provides a bridge that allows AI 
researchers to plug their systems into the WWW as it affords 
developers of distributed hypermedia standards a vehicle 
through which they can. 

As the Orchestra project demonstrates, it’s not only AI 
researchers who stand to benefit from adding CL-HTTP server 
capabilities to their software. A CL-HTTP server is basically a 
Lisp program, running on a (usually) networked computer, that 
“exports” certain URLs, making them visible to any machine on 
the network that is authorized to access them. CL-HTTP listens 
for network requests for these URLs, processes them, and 
returns HTML pages to the requesting clients. The exporting 
and processing of the URLs is where other programs hook into 
CL-HTTP server, as discussed below. 


As the Orchestra project demonstrates, 
it’s not only AI researchers who stand to 
benefit from adding CL-HTTP server 
capabilities to their software. 


PUTTING THEM TOGETHER 

The Orchestra program consists of over 80,000 lines of Lisp 
code. CL-HTTP, while not quite as large, is still a significant 
program. Using MCL, the process of making these two systems 
work together was as simple as loading them, adding a few 
functions and calls, and modifying a few Orchestra routines. Due to 
the interactive nature of MCL, it was not necessary to recompile 
anything more than the few files that had to be modified. 

CL-HTTP supports many types of URLs, including one type 
that causes a Lisp “response function” to be called when that URL 
is requested from a remote client. CL-HTTP passes the response 
function an object representing the URL, and a stream object to 
which the function sends its “response” (a stream of HTML text). 

Listing 4 shows the Lisp form that the Orchestra Fab Browser 
uses to instruct CL-HTTP to export the top-level URL for the system. 


Listing 4: Exporting the top-level Fab Browser URL 


(export-url #u”/fm. html” 
:=html-computed 
:response-function #’write-extended-factory-model 
:documentation “Top level access to fab model” 
:keywords ‘(:cl-http :fab-model) ) 


The #u’/fm.html” syntax will expand into a CLOS object 
representing a URL that looks something like this: 
http://some.place.com/fm.html (depending on the host machine’s 
network name, of course). The :html-computed value specifies to 
generate the kind of URL that is associated with a response 
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function, which itself is then specified as write-extended-factory-model 
(#foo is a Lispy way of saying “the function named foo”). The other 
parameters are optional CL-HTTP “housekeeping” information. 

The write-extended-factory-model response function is in 
Listing 5. 


Listing 5: The write-extended-factory-model response function 


(defmethod write-extended-factory-model 
((url http-computed-url) stream) 
(with-successful-response (stream :html) 
(let ((title “Wafer Fab Browser — Top Level”)) 
(with-html-document (:stream stream) 
(with-document-preamble (:stream stream) 
(declare-base-reference url :stream stream) 
(declare-title title :stream stream) ) 
(nsl.1:with-document-body 
(:background :white :stream stream) 
(with-section-heading (title :stream stream) 
(image-line :stream stream) 
(let ((*browser-conn* (find-browser-conn) ) 
(*output-stream* stream) ) 
(declare 
(special *browser-conn* *output-stream*) ) 
(with-rendition (:teletype :stream stream) 
(orch:factory-browser-initial-contents :mos6)) 
(fresh-line stream) 
(image-line stream) 
(wfb-signature stream)))))))) 

The above Lisp form defines a method (a function specific 
to a certain class or set of classes) called write-extended-factory- 
model, which will be called with two arguments: wl, which is an 
instance of the class http-computed-url (a class supplied by CL- 
HTTP); and stream, which is not specified to be of any particular 
type. 

There could be other methods of the same name, taking 
arguments which are of different classes; it is the CLOS object 
system which brokers which method is actually invoked when a 
call to write-extended-factory-model is made. 

with-successful-response, with-html-document, with-document- 
preamble, with-section-heading, and with-rendition are CL-HTTP 
macros used with code that generates HTML. Some of these 
macros use keyword arguments (e.g., :expires, :stream) to 
determine exactly what code to generate. Note that the name of 
the ns1.1:with-document-body macro is a symbol from the ns1.1 
package: there may be other macros named with-document-body 
defined in other packages. The other macros don’t have such 
package qualifiers because they have presumably been made 
accessible to the current package by means not shown here. 

The stream variable that is so prevalent above holds a Lisp 
object, supplied by the CL-HTTP system, that directs characters to a 
buffer that will be output by low-level networking code to a client 
browser. Instead of the stream value being passed down to 
orch:factory-browser-initial-contents, the “special” (globally accessible) 
variable *output-stream* is bound (set) to that value, so that other 
parts of the system will be able to direct their output there. 

declare-base-reference, declare-title, image-line are CL-HTTP 
functions that generate HTML text. Note that in general, the 
implementor does not have to be too concerned with whether a 


lisp form denotes a macro or function call. 
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find-browser-conn, orch:factory-browser-initial-contents, and 
wfb-signature are Fab Browser functions. The two variables 
. “browser-conn* and “*output-stream* are bound to (i.e., given) 
values in the enclosing let form, and because they are “declared 
special,” the functions called within that let form will have access 
to their values. 

From the above code, it’s apparent that the function 
orch:factory-browser-initial-contents is being used to generate the 
body of the HTML page presented to the client. The function 
must have previously been used to display a page of text in a 
Fred buffer, where clicking the lines of that text would elicit 
changes in the displayed text or other actions. Now, its job is to 
output a page of HTML text that contains hypertext links. Each 
link will need to have associated with it another exported URL, 





CL-HTTP has a special kind of URL, called a 
search URL, which allows one exported URL 
to elicit a range of responses from a number 

of different hypertext links. 





and each of those URLs would in turn need to have a response 
function which would be called by CL-HTTP when the link was 
clicked, to display a new page or take some other action. Hmm, 
that could turn into quite a-lot of URLs and response functions! 
Fortunately, CL-HTTP has a special kind of URL, called a search 
URL, which allows one exported URL to elicit a range of 
responses from a number of different hypertext links. Without 
going into too much detail on that mechanism (provided by 
[Mallery 1994]), we can show how such a URL would be used for 
the Fab Browser (see listing 6). 


Listing 6: Exporting the Fab Browser search URL 


(export-url #u”/expand?” 
:search 
:response-function if? respond-to-expand 
:documentation “Expand a fab object.”) 


Specifying #u”/expand?” and :search indicates that the 
function named respond-to-expand should be called whenever a 
URL that looks like the following is requested (where text 
following the ? can vary). 


http://some.place.com/expand ?somekey=value&anotherkey=othervalue 


SO, you can pepper an HTML page with such URLs, each 
having different keys and/or values, and when one is clicked, 
CL-HTTP arranges to call the proper response function, passing 
it that key/value information. The respond-to-expand is shown 
in listing 7. 
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Listing 7: The respond-to-expand search response function 


(defmethod respond-to-expand ((url http-search) stream) 
(with-slots (search-keys) url 
(with-successful-response (stream :htm1l) 
(with-html-document (:stream stream) 
(let ((title “Wafer Fab Browser”) ) 
(with-document-preamble (:stream stream) 
(declare-base-reference url :stream stream) 
(declare-title title :stream stream) ) 
(nsl.1l:with-document-body // (:background :white :stream stream) 
(let* ((browser-conn-id //(read-from-string (first search-keys) ) ) 
(browser-conn // (find-browser-conn browser-conn-id)) 
(object-id //(read-from-string (second search-keys)) ) 
(object // (browser-conn-lookup object-id browser-conn) ) 
(*browser-conn* browser-conn) 
(*output-stream* stream) ) 
(declare (special *browser-conn*) ) 
(with-section-heading (title :stream stream) 
(image-line :stream stream) 
(orch:expand object //(orch:plan-customer orch::*factory*) 0) ) ) 
(image-line :stream stream) 
(wfb-signature stream))))))) 


Since this method outputs an HTML page like the other 
method above it, they look pretty similar. Note that this method is 
defined for a different kind of URL (an instance of the http=search 
class). Also note that CL-HTTP uses the url object to stash the 
keys and values from the request — with-slots is a Common Lisp 
form that extracts a value (search-keys in this case) from a slot of 
a CLOS object (url in this case). CL-HTTP arranges for the search- 
keys slot to hold a list of the keys and values, as strings. Orchestra 
decodes them (read-from-string produces a Lisp object given a 
string, for example the string “259” would produce — you 
guessed it — the integer 259) then uses them to access internal 
database objects (via find-browser-conn, browser-conn-lookup) and 
finally, it passes those objects down to a function which will 
display the proper HTML page (orch::expand). That page, in turn, 
may contain other hypertext links, associated with the exported 
search URL or other exports that CL-HTTP was instructed to 
create. 

The above discussion demonstrates a few points about Lisp 
& CL-HTTP: 

e Using CL-HTTP macros to hide the details of HTML code 
generation; 

e Using packages to ensure that large programs (here, 
Orchestra and CL-HTTP) can be loaded together and 
communicate with each other; 

¢ Adding a small amount of code (the above two methods) and 
changing a small amount of code (the two functions in the 
ORCH package) can essentially create an entire new user 
interface for a Lisp-based program; 

And the result? From Davies’ paper: 

“... we ported the outline browser to CL-HTTP in about one 

person-week. The goals for the web implementation were 

achieved for the most part. Fab data is now accessible through a 

web browser to anyone in the wafer fab with a computer, 

whether Mac, PC, or UNIX. 

Figure 4 shows a number of Fab Browser windows using 
the new, web-based user interface. 
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Figure 4. Web-based Fab Browser windows. 


ORCHESTRA PLAYS ON 


Motorola’s Orchestra project will continue to evolve, and CL- 
HTTP has opened up new avenues of functionality for it. Besides 
the Fab Browser, the other parts of the system (fab model 
extraction software, historical data browser, scheduling system, 
and execution system) will find ways to benefit from the new, 
web-based user interface. The manufacturing managers and 
associates who use the system will continue to see improvements 
in their ability to access and manipulate the data they need. 


MCL Forces AHEAD 

MCL is also evolving. Digitool is improving its compilers and 
development environment; is developing a high-level interface to 
Open Transport (to be available early in 1997), and has projects 
under way involving QuickDraw 3D, QuickDraw GX, and 
OpenDoc. Soon, PowerPC MCL developers will be able to 
develop smaller stand-alone applications, and we are exploring 
ways in which to use the shared library mechanism to give users 
more delivery options for their programs. 
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Looking for a multi-platform, 
object oriented framework 
and extensible programming 
environment? Oberon/F 
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Ever thought about taking a break 
from the “same old stuff’? Or are you a 
Pascal devotee watching the wholesale 
switch to C and C++? Do you want a 
development system that works with and 
for you instead of you working for it? 
Looking for an object oriented framework 
that is cross-platform? Take a look at the 
Oberon/F system from Oberon 
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OBERON: THE LANGUAGE 

The computer language Oberon-2 was 
developed by Niklaus Wirth (Pascal, 
Modula-2) and his associates at the 
Eidgendssische Technische Hochschule 
(Swiss Federal Institute of Technology — 
abbreviated “ETH”) in Switzerland. It was 
developed, first as the language Oberon, 
and later Oberon-2, together with an 
environment and operating system also 
called Oberon. Originally, this was the 
foundation of the Ceres ETH workstation. 
Oberon and its environment have since 
~ been ported to many platforms, including 
the MacOS, various PC implementations, 
and a variety of UNIX machines. There are 


commercial versions of the language and environment for many 
different computers. 

The language Oberon-2 is a compiled, strongly typed, 
garbage collecting language with late-binding that is a 
descendant of Pascal and Modula-2. It is a simple yet powerful 
language that provides just the features necessary and no more. It 
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object-oriented programming. Pascal and Modula-2 programmers 
can read most Oberon-2 programs without much trouble, and 
after a little acquaintance, are soon writing programs of their 
own. C/C++ programmers must readjust a bit but can soon be 
using Oberon/F to create their own components. A good book 
on object-oriented programming that uses and demonstrates 
Oberon-2 is Hanspeter Méssenbéck: Object Oriented 
Programming in Oberon-2, Springer Verlag, 1993. ISBN 3-540- 
60062-0. 

Oberon (and Oberon/F) is an object oriented language. The 
language was developed with the notion of extensibility of 
software, especially by the user. Extensibility allows a user to 
extend the software without having any original source. This is 
different from the typical object oriented approach of class 
libraries where source code often must be available to the user of 
the libraries for further inspection and reuse. In Oberon, new 
functionality can be added at any time without the original 
software author's help. New software is added to or embedded in 
the user’s software to extend its original functionality, For 
example, a word processor can have a movie-playing module 
added by a different company at a later date without the word 
processor author having anything to do with it. 


THE OBERON/F IMPLEMENTATION OF OBERON-2 
Oberon/F is an implementation of the Oberon-2 language 
(called Oberon/L by Oberon Microsystems in their 
implementation) consisting of a run-time and development 
environment and an object oriented framework (hence the /F). 
The “look and feel” of the system and software developed with it 
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is that of the platform. Unlike other Oberon systems, Oberon/F 
does not impose its own user interface, and the familiar Mac or 
Windows interface is presented to the user. Oberon/F is available 
for the MacOS and for 32-bit Microsoft Windows (3.x w/Win32S, 
W95, NT). A UNIX/Motif version may be forthcoming. This review 
deals primarily with the MacOS version. The version reviewed is 
developer (commercial) version 1.2. 

Oberon/F for Mac requires a MacOS compatible computer 
with a 68020 processor or higher or a PowerPC processor. It also 
requires an FPU or FPU emulator when running on non-FPU 
versions of the 68K family as well as on the PPC.[SoftwareFkPU 
from John Neil works nicely. —ERR | 

Oberon/F on the Macintosh currently compiles 68K code 
only. Oberon Microsystems has announced that a PPC compiler 
should be available later this year. The lack of an available PPC 
compiler is unfortunate and I look forward to its arrival. 

Oberon/F uses a cross-platform framework for MacOS and 
Windows built on the Oberon-2 language. Though it is possible 
to create large double-clickable applications with Oberon/F, the 
emphasis in Oberon/F is on components, not monolithic 
applications. Release 1.2 includes its own efficient proprietary 
component system on the Mac and includes full support for OLE 
on Windows. OpenDoc support on the Mac is promised, and 
should be available later this year. This means that you can 
program your components using Oberon/F and they will 
automatically work in OLE and OpenDoc. Oberon Microsystems 
has also released an Oberon compiler with Direct-to-COM 
support for “Safer OLE” on the Windows platform. A Direct-to- 
SOM Oberon compiler on the Mac may be in the works, but the 
exact status of that project is unclear. [By press time, we were not 
certain of the status of several of these pending projects, such as 
the PPC compiler, the SOM compiler, native OpenDoc, and UNIX 
implementation. —ERR | 


UsING OBERON/F 
There are three general ways Oberon/F can be used on 

MacOs: 

° Use the Oberon/F framework (exclusively) to produce cross- 
platform software (components). 

° Use straight Oberon-2 language and program the MacOs 
similarly to the way one programs the Mac with Pascal or C 
using toolbox and manager calls. 

¢ Combine the two approaches: use the framework and add 
new custom framework modules to take advantage of MacOS 
specific features that are not in the framework’s built-in 
functionality, such as QuickDraw GX. 


Using The Framework 

The Oberon/F framework is modeled on the Models, 
Views, Controllers (M-V-C) model from SmallTalk and Xerox 
PARC. To program in Oberon/F you design your software so 
that the data is represented by a set of objects referred to as 
models. This data is accessed through views which can 
represent a given model in different ways. Manipulating the 
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data is done through a controller object. Different views 
can access the same model, and if the model changes, the 
views are notified to update their representations. 

Abstract sets of layers isolate modules from each other and 
from the hardware. This makes it easier to program for 
extensibility and to support cross-platform components. The 
hardware interaction is restricted to low level objects. The basic 
Store object represents persistent data on a given medium. This 
Store object provides reading and writing functions for mapping 
data types like integers, characters, etc. into binary data for 
storage on a disk or in a file. Models, Views, and Controllers are 
extensions of Store objects and are the basic building blocks for 
writing components in Oberon/F. The following listing is an 
example of a simple program that will take the selected text in 
the current window and perform a ROT-13 upon it. This 
program is in the form of a command which is a parameterless 
procedure used to extend another program. This module can be 
added to any Oberon/F program that runs in the standard 
Oberon run-time environment and that uses the standard 
Oberon/F framework subsystem called Text (or an extension of 
this subsystem). [4 ROT-13 jumbles and unjumbles text. It ts used 
by Usenet groups to hide the text from casual observers. —ERR | 

The program imports only those modules it will use, such as 
the Text subsystem. Inside our Do procedure we declare a 
controller, tc, a text reader, tr, a writer, tw, and a model, buf. We 
also declare some helper variables to represent the beginning 
and ending locations of the selected text and to hold the 
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current. The script is a special object that allows us to easily 
implement undo/redo functionality. We first set up our 
controller to point to the currently focused window. If it exists 
and has a selection then we get that selection and set our 
beginning and ending helper variables. We then instantiate a 
new writer for our model, buf, as well as a reader. Then we 
iterate over our selected text and do our ROT-13 operation. As 
we operate on each character, we save it to our model. After 
traversing the selection and building a new ROT-13 version in 
our local model, we copy it to our original text item and replace 
the original with the new version. The end result is that the 
original selection in our text window at command execution is 
now mixed up by a ROT-13 operation. 


Listing 1. 





MactechRot13 


(* This Module is a sample using the Oberon/F framework. It performs a ROT-13 on 
the current text selection. This module can be added to any program that uses the text 
subsystem. PROCEDURE Do is a parameterless procedure called a “command.” This is 
a complete module and can be compiled by itself. *) 


MODULE MactechRotl3;: 
IMPORT Models, TextModels, TextControllers, Domains; 
PROCEDURE Do’; 


VAR tc: TextControllers.Controller: 
beg, end: LONGINT; 
tr: TextModels.Reader; 
ch: CHAR; 
buf: TextModels.Model; 
tw: TextModels.Writer; 
script: Domains.Operation; 


BEGIN 

te := TextControllers.Focus(); 

IF (tc # NIL) & tc.HagSelection() THEN 
tc.GetSelection(beg, end); 
buf := TextModels.Clone(tc.text) ; 
tw :=buf.NewWriter(NIL); 
tr := tc.text.NewReader (NIL) ; 
tr.SetPos (beg) ; 


tr.ReadChar(ch); 
WHILE (tr.Pos() <= end) & ~tr.eot DO 
IF ((ch >= “a”) & (ch <= m”)) OR 
((ch >= “A”) & (ch <= “M”)) THEN 
ch := CHR(ORD(ch)+13 
ELSIF ((ch >= “n”) & (ch <= “z”)) OR 
((ch D9= “N”) & (ch <= “Z”)) THEN 
ch := CHR(ORD(ch) -13) 
END; 


tw.WriteChar (ch) ; 

tr.ReadChar (ch) 

END ; 
Models .BeginScript(tc.text, “Rot13”, script) ; 
tc.text.Delete(beg, end); 
tc.text.CopyFrom(beg, buf, 0, end - beg); 
Models.EndScript(tce.text, script) 
END 

END Do; 


END MactechRotl3. 


The Oberon/F framework as shipped includes two 
subsystems that can be used and extended. These are the Text 
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and the Forms subsystems. Oberon Microsystems, Inc. and third 
parties are releasing (or will release in the future) other 
subsystems including database access, high precision math, and 
others. For example, the Sql subsystem was recently released 
and is a full featured SQL access subsystem that comes with the 
dtF SQL database system. 

The Text subsystem provides basic formatted text services, 
similar to TextEdit. It includes styled text and other basic word 
processor features. The Oberon/F development environment 
itself relies heavily on the Text subsystem. Most programs will 
probably rely on the Text subsystem or on developer extensions 
to this subsystem for their text processing. 

The Forms subsystem allows easy development of user 
interface with dialogs and similar “form-like” objects. Each 
element in a given form is directly linked to an Oberon program 
variable. For example, a button may be linked to a boolean, a 
text field to a string, etc. When a user manipulates a button or 
types in the text field, the variable is automatically updated. 
Oberon/F also includes a visual interface designer to 
interactively build and test “forms.” 
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Figure 1. The forms subsystem links automatically to 
variables. There is a wide variety of graphical elements 
that can be placed in a form. 


Oberon/F For Traditional MacOS Programming 

Oberon/F can be used for its Oberon-2 language 
implementation alone to program traditional MacOS 
applications. In this scenario, the software developer controls 
and is responsible for everything, just as when using C/C++ or 
Pascal. The standard event loop must be supported, all 
managers must be properly initialized, and all other 
housekeeping chores must be completed. 

It is very easy to do traditional Mac programming with 
Oberon/F. If you already use Pascal, then switching to 
Oberon/F is a snap, as the languages are very similar and were 
invented by the same person. C programmers should also have 
little trouble once they shift into gear. Using the object oriented 
features of Oberon/F greatly expands the ability of the software 
developer to write robust software in a simple and maintainable 
way. With the garbage collection feature of the language, gone 
are many of the “Bus Errors” and memory leaks that so often 
afflict software written in other languages. 
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When using Mac specific data structures you must manage 
memory yourself, because Mac specific data structures used by 
the OS and the Toolbox lie outside the reach of the Oberon 
runtime system and cannot use garbage collection services. 
However, your application’s own data structures can take full 
advantage of Oberon’s features including garbage collection, 
and there are some techniques that allow you to take full 
advantage of garbage collection for your data structures that are 
referenced by the Mac. For example, using a window refCon is 
often used to keep an object pointer so that actions on windows 
can be done through a window’s object passed back to the 
program. However, the Oberon system is not aware that your 
window record maintains a link to your object and so will 
garbage collect your window object when your application is 
not using it. The Oberon system is not usually in control of your 
window record, because it is a Mac data structure. Alternatively, 
you can keep a separate list of window objects, or you can 





Many standard MacOS traps and routines 
are all available to the Oberon 
programmer out of the box. 





have the window object keep a reference to itself. By 
referencing itself, the garbage collector knows that the object 
still has outstanding references and will not dispose of it until 
you set the self reference to nil. 

Many standard MacOS traps and routines are all available to 
the Oberon programmer out of the box. This latest release of 
Oberon/F, V1.2, also gives us some automatic AppleScript 
support. The DoEvent Apple event allows one to execute any 
command (or parameterless procedure) externally through 
AppleScript or other AppleEvent aware application. 

Each separate manager has its own MODULE defined for it. 
Some managers such as QuickDraw GX are not predefined. You 
must define them yourself if you wish to use them in Oberon. 
This is a shortcoming that I hope Oberon Microsystems, Inc. 
soon remedies. 

The next listing shows a simple MacOS “Hello World” 
program in Oberon-2. This example does not use any Object 
Oriented features but shows how Mac toolbox routines are used 
in Oberon-2. 

First, we declare a MODULE name. The MODULE name is in 
the subsystem MacTech and is called HelloWorld. (A subsystem is 
similar to a “manager” or “project” — a set of related code modules 
making up your software.) If you go looking about the various 
Oberon/F directories you would find a Code folder inside a 
MacTech folder and in the Code folder you would find the 
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compiled version of the module with the name HelloWorld. The 
same goes for the Sym folder and the other Oberon folders for 
your subsystem. They contain the symbol files, source code, etc. 

Next we IMPORT those modules we want to use in our 
module. This is similar to #include-ing in C/C++ or USE-ing in 
Pascal. Each specific Mac toolbox manager we want to use must be 
included. You can provide shortcut names for your imports so that 
when referencing data types and routines from these imported 
modules you do not have to provide the complete module name 
each time. I have done that in this sample program in most cases. | 
did not do it for the Font Manager or the Window Manager to 
demonstrate the effect in the code of not doing it. MODULE 
SYSTEM is imported because we use some MacOS specific Oberon 
routines as well. These routines, provided by Oberon 
Microsystems, Inc. help us interface to the Mac. 

Our MODULE-level global variables are declared next. Then 
we declare our first procedure. This is a simple procedure that 
initializes all the Mac toolboxes for us (including ones we are not 
using in this simple program). Notice that each call we make or 
each datatype we use is prefaced with the name (or shortcut) of 
the module that contains it. 

We then define the substance of our program, the 
PROCEDUREs MakeWindow and HelloWorld. MakeWindow creates 
a new window for us, displays it on the screen, and fills in the 
titlebar, HelloWorld writes the words “Hello World” in big letters in 
the middle of our window. 

PROCEDURE Do is our “main” procedure and it calls the 
other routines in the proper order. Note that it is declared with an 
asterisk “ after it. This means that it is to be exported from 
MODULE MacTechHelloWorld. It is also directly callable from the 
Oberon/F environment. You would merely type and select 


MacTechHelloWorld.Do 


and then choose Execute from the Dev menu and your 
program runs. Note also that the program body is blank. If 
this program were to be linked by the developer into a 
double clickable application, then the program body would 
call the Do procedure. 


Listing 2. 





MODULE MacTechHelloWorld 


(* This module demonstrates a simple “HelloWorld” program using the Mac toolbox 
calls with Oberon. This is a complete module by itself and can be compiled and run 
as is. *) 

MODULE MacTechHelloWorld; 


IMPORT 
SYSTEM, 
RM := MacResourceMgr, 
QD := MacQuickDraw, FS := MacFileMgr, 
MacFontMgr, MacWindowMgr, 
MN := MacMenuMer, TE := MacTextEdit, DL := 
MacDialogMegr, 
MT := MacTypes, 
EV := MacEventMgr, ME := MacMemoryMgr, OS := 
MacOSUtils; 
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VAR 


gWindowRect : QD.Rect; 
gWindowRefCon : LONGINT; 
gWindow : MacWindowMgr .WindowPtr; 


(* InitMac initializes the Mac ToolBox *) 
PROCEDURE InitMac; 
BEGIN 
QD. InitGraf(QD.globals.thePort) ; 
(* The QuickDraw Globals are Oberon Variables *) 


MacFontMgr.InitFonts; 
MacWindowMgr.InitWindows; 
MN.InitMenus; 

TE. TEInit; 
DL.InitDialogs(0); 
QD.InitCursor; 


END InitMac; 


(* Create a new window and display it *) 
PROCEDURE MakeWindow; 


VAR 

windowTitle : MT.Str255; 

temp : ARRAY 256 OF CHAR; 

behind : MacWindowMgr.WindowPtr; 
(* behind flag in NewWindow *) 


BEGIN 


temp := “MacTech Magazine”; 

behind := SYSTEM.VAL(MacWindowMgr.WindowPtr, -1); 
MT.SetStr255(windowTitle, temp); 

QD.SetRect (gWindowRect, 50, 200, 300, 400); 


gWindow := MacWindowMgr.NewWindow(NIL, gWindowRect, 
windowTitle, TRUE, 
MacWindowMgr.noGrowDocProc, 


behind, TRUE, gWindowRefCon) ; 


MacWindowMgr. ShowWindow(gWindow) ; 


END MakeWindow; 


(* Draw our “HelloWorld’ string in the window *) 
PROCEDURE HelloWorld; 
VAR 

oldPort : QD.GrafPtr: 

helloWorld : MT.Str255; 

temp : ARRAY 256 OF CHAR; 
BEGIN 


temp := “Hello World”; 
MT.SetStr255(helloWorld, temp) ; 


QD.GetPort(oldPort) ; 
QD.SetPort (gWindow) ; 


QD.TextSize(26) ; 


QD.MoveTo(25, 100); 
QD.DrawString(helloWorld) ; 


QD.SetPort(oldPort) ; 
END HelloWorld; 
(* Create our Do command. Can be run inside the Oberon environment. *) 
PROCEDURE Do?*; 
BEGIN 


InitMac; 


MakeWindow; 
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HelloWorld; 


REPEAT 
UNTIL EV.Button(); 


MacWindowMgr .DisposeWindow(gWindow) ; 
END Do; 


(* Main program begin. If we are to compile and link this as a separate application then 
this section should make a single call to Do; *) 
BEGIN 


END MacTechHelloWorld. 


External routines and the CFM Manager 

The Oberon/F system supports the Code Fragment Manager 
(CFM) for external routines. This means that you can use any 
language that supports CFM to write routines and then use those 
routines in your Oberon programs. This allows you to take 
advantage of third party and Apple libraries as well as your own 
code. Even though I have not tried it, it should allow you to 
interface with SOM routines if you know the SOM names for your 
routines and how SOM works. On a PowerPC MacOS computer, 
CFM-access allows you to directly interface with PPC code, and 
the runtime system will make all the appropriate 
UniversalProcPtrs for you and make it all work. On PPC 
machines this is an easy way to interface with those Mac 
managers that are not predefined for you. (68K machines with 
CFM-68K can access CFM-code as well.) To use the CEM libraries, 
you define an Oberon Module that contains the routines to link. 
This module is then imported into your Oberon code and used 
regularly. See the following listing for an example. 


Listing 3. 





~ MODULE BeepUtil 


MODULE BeepUtil [“InterfaceLib”] ; 


PROCEDURE SysBeep* (duration: INTEGER) ; 
END SysBeep; 


END BeepUtil. 


No code is generated when this is compiled but your 
Oberon MODULEs are free to call any of these routines and the 
runtime system will search for the appropriate code fragment, 
load it and run the routine desired. 


Oberon/F and Mac Specific Extensions 

One powerful way of using Oberon/F is to use the 
component framework and extend it for your own Mac-specific 
needs. This allows your modules that do not call Mac specific 
code to work correctly cross-platform. Only those modules that 
actually call Mac specific code need separate Mac and Windows 
implementations. This allows you to use API’s like QuickDraw 
GX on Macs and an equivalent package on Windows and still 
have the substance of your application be cross-platform. 
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THE OBERON/F DEVELOPMENT ENVIRONMENT 
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The Oberon/F development environment is a specialized 
subsystem running in the standard Oberon/F run-time 
environment. The development environment includes a text 








Loaded Modules 
Global Variables 
view siete 








“Edit Mode 
Layout Mode 
Browser Mode 



















editor (using the Text subsystem), compiler, linker, visual meth Nore ircsbhcebad: ope Source 
Apaiahing teed dial H > and h “Pecr tives tet ed] limi Ra Feds slat Interface 
a ‘ at intertace 
esigner Or forms an la O§s, A Cap Spy ) and some s ortcut Open File List Insert Up/Down Field Documentation 





Search In Sources 
Search In Docu 


commands that can create skeleton programs for you. The 
development environment is fully extensible. You can change 
any of the menus and add any of your own code to it as well. A 
source code analyzer and a statistical profiler tool for 
performance analysis are available separately from Oberon 
Microsystems for a modest fee. 
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Download the Architectural Overview 


With garbage collection, many typical program bugs are 
eliminated automatically, with no more memory leaks or “bus 
errors” (except when interfacing directly to the system). 
However, errors of logic and other bugs will still afflict an 
Oberon program. Typical Oberon development is to design the 
project, code the modules, and use assertions to test each 
routine. If, when testing a running program, an error occurs, a 
stack crawl trap window appears. This window displays the error 
trap that occurred and a stack crawl. You can examine the 
variables of each routine in the stack crawl as well as go directly 
to the source code of any routine in the stack crawl. (See Figure 
1.) As the Oberon/F help files say, the debugging facilities are a 
cross between a “post-mortem” debugger and “run-time” 
debugger. The debugging facilities are integrated into the 
development environment and when a program has an error 
trap, the rest of the system continues to run. The system degrades 
gracefully whenever possible. The Oberon/F language, 
environment, and debugging facilities lend themselves to quick 
debugging of problems with careful use of assertions and the 
error trapping facilities. 
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Figure 3. Debugger/stack crawl window. 


The complete environment comes on two compressed 
floppies. No CD is needed, nor do you need large amounts of 
hard disk space. The complete system includes the compiler and 
development/runtime environment, Text and Forms subsystems, 
help files, on-line documentation for the Oberon-2 language and 
the Oberon/F package, and examples. On my system, this took 
up slightly more than 7.1 MB (5,213,993 bytes). The compiler is 
very fast and the interactive environment makes rapid 
development fast and easy. 

Oberon/F makes an excellent development system for those 
wanting to develop quality component software on the 
Macintosh (and Windows). The language allows for object- 
oriented, modular, and structured programming techniques. It is 
a clean and simple language, and is garbage collected for safety. 
It supports late-binding to allow for run-time extensibility of 
software. The Oberon/F framework is completely cross-platform 
on Macintosh and 32-bit Windows and can also be extended for 
platform specific use. Oberon and Oberon/F are being used 
commercially, especially in Europe, by those companies who 
want fast and accurate development of software. 
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OBTAINING OBERON/F 


Oberon Microsystems, Inc. is in Zurich Switzerland. Their 
distributor in the USA is dtF Americas. Their address is: 


dtF Americas, Inc. 

19672 Stevens Creek Blvd., Suite 128 
Cupertino, CA 95014 USA 

voice 800-dtF-1790 

fax 510-828-8755 

email: dtF@interramp.com 


The address and contact info for Oberon Microsystems, Inc. 
in Switzerland is: 


Oberon Microsystems, Inc. 

Technopark 

Technoparkstrasse 1 

CH-8005 Zurich Switzerland 

fax +41 1 445 1752 

email: oberon@oberon.ch 

WWW: http://www.oberon.ch/Customers/omi/ 


To subscribe to their announcements mailing-list send the 
following: “subscribe to Oberon/F announcements” to 
oberon@oberon.ch. 

The price from Oberon Microsystems, Inc. is 450 CHF 
(Swiss Francs) for the Macintosh or Windows developers 
versions. An educational version is available at no cost. The 
major difference between the educational and commercial 
developer versions is the absence of an external linker in the 
educational version (and no OLE support in the Windows 
educational version). This means that all code written with the 
educational version must run in the Oberon/F runtime 
environment and stand alone applications cannot be created. 
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downloaded from the internet from the WWW site. Contact dtF 
Americas directly for information on their US offering of 
Oberon/F. Wa 
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By Lee Ann Rucker, Sunnyvale, CA 








Making Smalltalk with the Macintosh Toolbox 





Using VanGogh and the 
next version of 
VisualWorks to build 
multiplatform applications 
with an Object-Oriented 
Smalltalk Interface to the 
Macintosh Toolbox 


INTRODUCTION 


VisualWorks is a Smalltalk application 
development environment from ParcPlace- 
Digitalk providing a very high degree of 
portability. Applications developed in 
VisualWorks run unchanged on a variety of 
platforms including Macintosh, Windows, 
OS/2 and unrx. Unfortunately, it achieves this 
portability at the expense of platform 
compliance, by emulating all user interface 
elements (“widgets”) using a small set of 
platform-specific graphic primitives. 

This article discusses the VanGogh 
platform architecture — the reasons for its 
creation, how it manages cross-platform 
compatibility while providing native look- 
and-feel, how it works with the VisualWorks 
framework, and how it can be used to write 
Macintosh-specific code. 


HISTORY 


In the early versions of Smalltalk, the user interface on all 
platforms used a variation of the original Smalltalk look. The 
release of VisualWorks 1.0 added the concept of “LookPolicy”. 
Each user interface had its own LookPolicy — MacLookPolicy, 
WinLookPolicy, etc. The emulation allowed cross-platform 
developers the opportunity to preview how their applications 
would look on the deployment platform. However, the benefits 
of this were overshadowed by the increasing liabilities — the 
challenge of faithfully rendering a given platform’s look and 
especially feel and the maintenance cost to keep up with changes 
to the interfaces, which became even more difficult when 
customizable looks were introduced for Macintosh and 
Windows. The Macintosh look used the pre-System 7 black-and- 
white controls exclusively, the menu bars were a part of the 
window, scroll bars alongside the edge of a window were not 
constrained to their proper position, and the grow box was 
obscured by the window contents (Figure 1). 
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Figure 1. VisualWorks Macintosh 
window containing the menu bar. 


The objective of the VanGogh project is to provide a 
VisualWorks product that maintains the portability of its 
predecessors, but adds host compliance by connecting directly to 
host widgets. In addition, it allows platform-specific codethat can 
coexist with writing applications that use the portable 
VisualWorks framework. 





Lee Ann Rucker is a senior software engineer at ParcPlace-Digitalk, and is responsible for the design and implementation of 
the Macintosh version of the next generation of VisualWorks. 
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VANGOGH ARCHITECTURE 

One of the goals of VanGogh was to maintain cross- 
platform portability. To that end, we implemented a layered 
architecture, shown in Figure 2. It divides objects into three 
layers: in the top-most layer are portable objects that are able to 
draw on the services provided by two lower layers. The middle 
layer implements a layered arch consisting of Bridge objects that 
supply a platform-independent API to the portable objects using 
capabilities drawn from the bottom-most layer. This bottom- 
most layer is shown in Figure 2. 


portable layer 


portable API 


bridge layer 


platform API 


platform 


ery C) access layer 





Figure 2. Layered Architecture. 
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Portable layer 

The Portable layer is used by a HostLookPolicy and has exactly 
the same interface, so existing applications already accustomed to 
using a LookPolicy for user interface elements run unchanged. 

VanGogh allows the new framework to retain the snapshot 
portability of traditional VisualWorks, which allowed a system to 
be restarted in exactly the same state as when it was saved, a 
“snapshot” in Smalltalk terminology. When the snapshot occurs, 
the portable objects query their bridges for the current state. On 
restart, new Bridges and Proxies, appropriate for the platform, 
are created using the state stored in the snapshot. Thus a system 
can be shut down on a Macintosh and restarted on Windows, 
and it picks up precisely where it left off. 


Bridge layer 

The Bridge layer provides the portable layer with a 
platform-independent interface to the host. The interface 
between the Bridge and Portable layers is identical for all 
platforms. Each class in the Portable layer is matched with a 
class in the Bridge layer. However, the implementation and 
actual class hierarchy in the Bridge layer differs on each 
platform to take advantage of variations in implementations of 
the platform objects. 
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Platform access layer 

The purpose of a platform access layer is two-fold. To 
provide support for the portable objects (“Proxies”) and to 
furnish convenient direct access to the platforms facilities for 
discretionary use by the application developer. Proxy objects 
provide an interface to Toolbox functions, methods for 
accessing structure fields, utilities to support changes in the 
Macintosh user interface, and finalization. We discuss these in 
greater detail in the section “Features of Proxies.” 

Many of the proxy classes (see Figure 3) correspond fairly 
directly to the various Macintosh Toolbox Managers. Other 
classes support user interface elements not provided by the 
Macintosh, such as dividers and notebooks. 


Event handling 

One of the features provided by the Bridge is event 
dispatching and processing. VanGogh provides standard event 
processors for every component. Low-level Macintosh events 
are dispatched to the Bridges that use the proxies to handle 
them, then creates high-level VisualWorks events such as value 
or focus change. 


MacAbstract Proxy 


| 
MacComponent Proxy 


MacControl Proxy MacListProxy  MacScrollingProxy MacStatic 
Mac PopUpMenu Proxy L MacListRef MacCustoms crolling Proxy MacStaticLabel 
F MacEnhContral Proxy MacStaticScrolling Proxy MacActiveLabel 
MacControlRef MacActiveScrolling Proxy MacGroupBox 
Mac TextEdit Proxy MacStaticLineSegmen 
L Mac ProtectedTextEdit MacStaticShape 


MacAbstract Proxy 


SSS 


Machenu Proxy MacQuickdraw Proxy 
[MecMenu BarProxy MacGiWorld Proxy 
MacHelpMenu Proxy MeaciWindow Proxy 
MacDialog Proxy 
MacFlostWindow Proxy 
MacWindowRef 





Figure 3. Proxy Class Hierarchy. 


FEATURES OF PROXIES 

Proxy classes are used to implement an object-oriented 
Toolbox. Its structure parallels as closely as possible to the 
Toolbox Managers, along with additional classes to support user 
interface elements not provided by the Toolbox (Figure 3). The 
methods are derived from the Toolbox API following a standard 
convention, and utility methods are added to standardize the 
API, allowing the abstraction of common functionality. 


Toolbox methods 

Toolbox methods are Smalltalk versions of functions provided 
by the Toolbox. To allow easy conversion from the Toolbox, we 
have adopted a consistent naming convention for Toolbox 
methods. According to this convention, Toolbox methods are 
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created from Toolbox function names by removing the identifier for 
the corresponding Manager. The initial letter is lowercase for 
compliance with Smalltalk. Though this may seem more confusing 
than simply keeping the names of the Toolbox functions intact, it 
provides benefits in an object-oriented environment. 

Consider the following: DisposeControl, TEDispose, 
DisposeWindow, DisposeMenu, DisposeDialog, LDispose, 
DisposeRgn, DisposeGWorld. Following the convention, all of 
these are implemented in the Proxy as dispose. We now have a 
uniform means of disposing of these Toolbox elements, while 
still keeping the names similar enough to the Mac Toolbox so 
that a Toolbox programmer will have little trouble converting 
existing Toolbox code. 

The naming convention for methods with more than one 
parameter is to use the parameter name in the function specification 
as the Smalltalk keyword. (in Smalltalk, keyword messages are 
methods whose names consist of words followed by arguments, and 
the words themselves are called keywords.) For example, DragControl 
is defined in the Toolbox Assistant as follows: 


void DragControl(ControlHandle theControl, Point *startPt, 
const Rect *limitRect, const Rect *slopRect, 
shorteaxis); 


We know that theControl corresponds to the proxy, so startPt 
is the first parameter of the corresponding Toolbox method. 
Therefore the method name is composed of the names of the 
remaining parameters, and when sent to a control object is used 
as follows: 


aControlProxy drag: startPt limitRect: limitRect slopRect: 
SlopRect axis: axis 


Finalization 

When the Proxy is finalized as part of Smalltalk’s automatic 
garbage collection, the handle is automatically disposed of using 
the dispose method as described in the Toolbox Methods section. 
This helps prevent resource leaks and double-disposing, both 
common problems in Macintosh programming. 


Toolbox extension methods 

The Apple Human Interface Guidelines specify some 
behaviors and graphical elements which the Toolbox does not 
provide: typing selections in Lists, the keyboard focus border on 
Lists, the default border on default Push Buttons, the border and 
scroll bars for a TextEdit and the window grow box. Inside 
Macintosh and Apple DTS provide sample implementations of 
these facilities, which we include in the Proxies as Apple 
extensions to the Toolbox. 


Shortcut methods 


Proxies provide shortcut methods that simplify calling 
certain Toolbox methods. 
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e Methods with parameters that are ignored, either by the 
MacOS or by the programmer. Shortcut methods provide 
default values or placeholders where needed. 

e Accessor methods which obtain values by passing a pointer 
to a parameter. Shortcuts for these methods create a 
temporary pointer and return the pointer contents. 

The following example of a shortcut for GetDltem 
demonstrates both kinds of shortcuts — it provides placeholders 
for the unused itemType and box, and returns the contents of the 
pointer to the item. The section “Using the toolbox directly” 
discussed below, shows how to use this method. 


MacDialogProxy 
getItem: itemNo 


“Answer a handle to an item so that you can manipulate it” 
| itemType item box | 


“Allocate temporary pointers for the parameters” 
itemType := Host api short malloc. 


item := Host api Handle malloc. 
box := Host api Rect malloc. 
“Call the Toolbox” 


self getItem: itemNo 
itemType: itemType 
item: item 
box: box. 

‘item contents 


Enhanced methods 


As the Macintosh User Interface evolved, Apple sometimes 
had to overload existing functions to provide new capabilities. 
One example of this is submenus — these did not exist in early 
System versions. A submenu is added by overloading 
SetMenultemCmd, and passing in a special constant for the 
cmdChar. We conceal the clumsiness of these overloaded 
functions by providing enhanced methods like this one that takes 
the item and submenulD and calls SetMenultemCmd with the 
appropriate constant. 


MacMenuProxy 
setSubmenu: item submenuID: aMenuID 


“Utility to set itemCmd and itemMark correctly for a submenu with the given id” 


self setItemCmd: item 
cmdChar: #hMenuCmd; 
setItemMark: item 
markChar: aMenuID 


Data conversion 
Toolbox methods provide data conversion when calling the 
Toolbox. 
e Smalltalk Booleans are converted to integers. 
¢ Smalltalk Strings are converted to Pascal Strings, which begin 
with a length byte. 
° Toolbox flag constants are passed in a Smalltalk Set and 
automatically “or”’ed together. 
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The following example from the MacAppleEventProxy calls 
the Toolbox method representing AESend. 
“Send an AppleEvent without waiting for a reply” 
self send: theEvent 
reply: reply 
sendMode: #(#kAENoReply #kAENeverInteract 
#kAECanSwitchLayer) 
sendPriority: #kAENormalPriority 
timeOutInTicks: #kAEDefaultTimeout 
idleProc: nil 
filterProc: nil. 
Complex types like Points and Rects are not converted in place 
by Toolbox methods, though there are utility routines that will 


convert complex types to and from their Toolbox representations. 


Accessor methods 

Proxies provide accessors to structure elements. This allows 
us to rationalize the names that can simplify the code. It also 
gives the appearance of data hiding, an important feature of 
object-oriented programming. 


Other utility methods 

VisualWorks sometimes does operations or requests 
information not directly available from the Toolbox. For 
example, VisualWorks has a bounds method that moves and 
resizes a widget. It also explicitly sets the row height of a List, 
because it scrolls the List in pixels, not rows. Utilities like bounds, 
which may be generally useful, are implemented in the Proxy to 
avoid forcing the Toolbox programmer to duplicate code. Others, 
such as setting the row height, are implemented in bridge objects 
as Toolbox programmers seldom need them. 

Other utilities rationalize the names of functions that exist in 
different forms for different proxies — activation, for instance, is 
done by passing 0 or 255 to HiliteControl, true or false to 
HiliteWindow and LActivate, and calling either TEActivate or 
TEDeactivate. We add an isActive method to all of the appropriate 
proxy classes that calls the corresponding Toolbox method and 
checks to determine whether the object is in an active window. 
The following examples show the isActive methods for Controls, 
Lists, and TextEdits. Note that the TextEdit method includes an 
extra check to see if the activation is changing, because activating 
an already active TextEdit causes annoying flickering. 


MacControlProxy 
isActive: aBoolean 


“Make this proxy active or inactive” 
isActive := aBoolean. 
“Control is active iff isActive is true and window isActive is true” 
self isActive 
ifTrue: [self hilite: 0] 
ifFalse: [self hilite: 255] 


MacListProxy 
isActive: aBoolean 


“Make this proxy active or inactive” 
isActive := aBoolean. 
“List is active iff isActive is true and window isActive is true” 
self activate: self isActive 
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MacTextEditProxy 
isActive: aBoolean 


“Make this proxy active or inactive” 
| wasActive | 
“Don’t set activation if it’s not changing - bad behaviour results” 


wasActive := isActive. 


isActive := aBoolean. 
“TextEdit is active iff isActive is true and window isActive is true” 
wasActive = self isActive ifFalse: [ 
self isActive ifTrue: [ 
self activate] 
ifFalse: [ 
self deactivate] | 


Using the toolbox directly 
Sometimes there is no reason to use a proxy object, and it is 
better to call the Toolbox directly. 

e When the Toolbox function operates on a global state, rather 
than a parameter. For example, QuickDraw drawing functions 
operate on the currently active GrafPort. Although it is possible 
to use a QuickDraw Proxy, it is more efficient to do drawing the 
traditional way, by setting the port and then performing a series 
of drawing operations. 

e When the host resource is not created by the programmer, it has 
no Proxy object. For example, the controls in a Dialog or List 
are created internally by the Toolbox. The code snippet below 
uses the shortcut method shown above to get a ControlHandle 
from a dialog proxy, then calls the Toolbox directly to set its 
value. 


control := dialogProxy getItem: i. 
Host api SetControlValue: control theValue: aValue 


EVENT HANDLING 


Event Dispatcher 

The VanGogh environment maintains a_ single 
MacEventDispatcher object. This object polls WaitNextEvent, 
handles suspend/resume events, and dispatches window events to 
the appropriate window. 

When an event occurs on a specific window, the Event 
Dispatcher object sends a MacEventProxy object to the Smalltalk 
object which has registered an interest on that event on that 
window. The following example shows how a windowBridge 
registers an interest on mouseDown events which occur in a 
particular window. 


windowProxy forwardEvent: #mouseDown to: windowBridge 


The Event Dispatcher object allows registry of window 
events and nullEvents, which are sent to the currently active 
window. The inclusion of nullEvents allows windows a chance to 
do any recurring operation, such as sending idle to the currently 
active TextEdit proxy. 

We don’t dispatch user input events to component proxies in 
the MacWindowProxy. The Bridge level handles this for 
VisualWorks. The utilities that the bridge uses when handling 
events are part of the Proxies and are accessible to non- 
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VisualWorks code. Amongst these, the most complicated is the 
findChild: utility discussed in the next section. 


The findChild utility method 

The Macintosh Toolbox does not provide a general-purpose 
hit testing routine. FindControl is a useful function, but it has its 
limitations. As anyone who has used it on a window with Lists 
has discovered, it will return the ControlHandle for controls 
created as part of a List. This causes problems when trying to 
write generic tracking routines, as those controls must be 
handled by LClick, not TrackControl. 

The findChild method implemented in MacWindowProxy, 
provides a way to identify which proxy was hit on a window. It 
works by first using FindControl. If a control was hit, we check 
the control’s refCon to determine whether the control is part of a 
List or other composite proxy — the refCon of a subcontrol holds 
the handle of the proxy that it belongs to. 

If FindContro! doesn’t find anything, then the proxy hit may 
be a List or TextEdit, or one of the enhanced proxies. In this case, 
findChild sends the hitTest method to all the proxy objects 
contained by the window proxy object. A proxy must return true 
if the mouse point is within its boundaries and it is capable of 
handling mouse events. 

If the point is not in an active proxy, findChild returns nil. 
Otherwise, it returns a MacEventDetails object which contains the 
proxy that was hit and any extra information needed for tracking, 
such as the part code or scroll bar. This extra information is used 
during scroll-bar tracking, amongst other things. 


Event Proxy 

The MacEventProxy represents a Macintosh EventRecord. 
After EventDispatcher determines which window should receive 
the event, the WindowBridge dispatches the event to the 
appropriate subcomponent. 

For example, if the mouse is clicked in the scroll bar of a list, 
the EventDispatcher would send a mouseDown event to the 
window bridge. The window bridge would find the part hit, in 
this case inContent, and call mouseDownInContent. This dispatches 
the event to the result of findChild. 

The findChild for the list sets the keyboard focus, then sends 
the event to the Proxy, using the proxy method for LClick. It uses 
the scroll bar information in the details object to make sure it 
doesn’t update the selection when the user scrolls. 

The elements of the EventRecord are accessed using 
Smalltalk methods with the same name as the struct elements. We 
also add utilities such as local, that returns the point local to the 
front window. 


MacScheduledWindowBridge 
mouseDownInContent: theEvent 


“Handle a mouse down event in the content area of my window” 
| thePoint eventDetails | 


“Get the local point for my window” 
thePoint := theEvent local. 
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“Find the child which was hit. The result contains the proxy hit and any extra 
information it may need, or nil if nothing hit” 


eventDetails := self macWindow findChild: thePoint. 
eventDetails isNil ifTrue: [*nil]. 


“Send the event to the bridge representing the child” 
(self bridgeFor: eventDetails proxy) mouseDown: theEvent 
details: eventDetails 


MacHostListBridge 
mouseDown: theEvent details: anEventDetails 


“Handle a mouse down event at the specified point, with the given modifer keys pressed. 


anEventDetails stores information needed to determine which part of the List was hit” 
| isDoubleClick lastClick | 


self listBox hasFocus 
ifFalse: [self setFocus]. 


“Send the click information to the toolbox,*and answer whether it was a double click” 


i+sDoubleClick := self listBox click: theEvent local 
modifiers: theEvent modifiers. 


“anEventDetails details is nil if hit in my content, otherwise it is the scroll bar handle. 
We don’t want to send selection changed when the scroll bar was hit’ 
anEventDetails details isNil ifTrue: | 
lastClick := self listBox lastClick. 


self updateWidgetSelections: lastClick. 
isDoubleClick ifTrue: [self widget eventDoubleClick] ] 
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Menu and Menu Bar Proxy Fe 

The MacMenuProxy provides access to the Menu Manager. 
The Menu Manager provides support for individual menus, but 
very little support for multiple menubars, as the original 
assumption of the Macintosh User Interface was that each 
application had a single menubar. VisualWorks assumes multiple 
menubars, as is the case in many other platforms. Therefore, the 
MacMenuBarProxy class provides the support that allows each 
window its own menubar. 

VanGogh creates a MBarHandle for each window and 
uses SetMenuBar to reinstall it when the window is switched to 
the front. MenuBars that change with the context have become 
accepted with the introduction of OpenDoc and their usage in 
applications such as Word and Netscape. 


Visit MacTech Magazine’s Web site! 


htto://www.mactech.com 
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Figure 4. The VanGogh Programming Environment. 


Figure 4 shows the VisualWorks development environment 
with the Launcher’s window and menubar active. The menubar 
proxy works with the event dispatcher to provide setup and 
handling of the Apple, Application and Help menus, and the 
MacHelpMenuProxy class provides utilities for adding and 
managing items on the Help menu. 

We also provide facilities within the VisualWorks 
framework for Smalltalk-style pop-up menus controlled by 
option-clicking or three-button mice. Although not Mac- 
compliant, these are available for use by Toolbox programmers. 


Undo Proxy 






UndoProxy 


cresteUndoDats: theData code: theCode 


dats := theData 
code := theCode 
undo 


perform: code with: data, 




















doSomething: newDats 
createUndoData: myData code: undoSomething 
myData ‘= newDats, 










undoSomething: oldDats, 
myData = oldDats 






Figure 5. The Undo Proxy. 


The MacUndoProxy (Figure 5) stores the data and code 
objects needed to perform an Undo operation for a 
particular proxy. This is an example of the Memento pattern 
(Gamma et al 1995). , 

To do an Undo you must store the state of the object prior 
to the undoable action, and some way of determining how to 
effect the undo. The simple way to do this is to store the value 
and restore it for an Undo, but that is only feasible for simple 
objects like Controls — for Text objects this could result in the 
duplication of quite a lot of text. Therefore, the TextProxy 
creates an UndoProxy and stores just the text to be changed 
(the current selection or empty selection), the location of the 
text, and a BlockClosure, which is a section of code that is 
bundled with its context, to store the code needed to undo the 
action. When it is time for the undo, the Undo Proxy simply 





MAKING SMALLTALK WITH THE MACINTOSH TOOLBOX 


executes the stored code. Since the context of the code is that 


. of the object that needs the undo, it has access to that object 


and all the information stored in the undo proxy for that object. 
If the action is a paste, the undo is treated as a paste, which 
includes creating an UndoProxy to undo this undo. 

Since Smalltalk is an untyped language, the data in the 
UndoProxy can be any object. For instance, a draw program might 
store a shape object and its current size to undo a cut or resize. 

One advantage of an object-oriented language like 
Smalltalk is that UndoProxies are self-contained objects linked 
to the Proxies that created them, and the programmer does not 
need to keep track of them. The standard Undo menu handler 
for a Proxy simply executes the UndoProxy if it exists. 


Creator Objects 

The Creator object uses the Accumulator pattern (Yelland 
1996) to gather information needed to create a platform object. 
While some Toolbox calls to create platform objects are fairly 
simple, others are quite complex. Consider the Toolbox call to 
create a new control. 


NewControl(myWindow, &aRect, iPush Met, true, 0, 0, 1, 
pushButProc | useWFont, 0); 


A direct transcription of this into Smalltalk would be rather 
clumsy. In addition, all pushbuttons share the same value, min 
and max. Rather than require all default values be explicitly 
declared, and attributes defined by flags to be specified all at 
once with a somewhat clumsy series of ORs, we use the Creator 
object. This object is created when a particular widget is being 
built and understands messages which set the various attributes. 
Any attributes not set when the widget is finally created use 
default values. The flag attributes are specified by individual 
messages to the Creator, which makes the code more readable as 
well as allowing sets of attributes to be set independently — 
scrollBars, for example, don’t need useWFont, so the test 
whether that should be used is only done in the code specific to 
the various Buttons. 

The code below creates the same button as above. The 
actual VanGogh code is even simpler, as the button classes use 
abstraction to set most of the values, since another advantage is 
that not all attributes need be declared in the same statement. 


buttonProxy := (MacControlProxy creatorClass new) 
pushButton; 
useWindowFont ; 
title: é@Push Mei; 
bounds: aRect; 
parent: myWindow; 
create. 


In addition: 
¢ It sets the parent-child relationship between a window and 
other proxies, so that hit testing and updating are handled 
correctly. 
¢ It sets the refCon in controls that are part of other host 
resources so that their owner can easily be identified. 
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e It establishes the relationship between a menu bar proxy 
and its window, so the correct menu bar is installed when 
the window is active. 

e It blocks context switching during TextEdit creation. Unlike 
other creation functions, TENew does not take a GrafPtr as a 
parameter, so if the GrafPort gets changed by another 
thread, the TextEdit will be created on the wrong window. 


SAMPLE CODE 

The Sample Code shows how to create a proxy for a Type- 
In Pop-Up Menu Control, as described in Macintosh Human 
Interface Guidelines, pages 91-92. The MacTypeInPopUpProxy 
class provides methods which create subcomponents (a TextEdit 
and a PopUpMenuControl), set the bounds, and handles events 
specific to this kind of control. The mouseDown event for the 
menu subcomponent must insure that the menu displays the 
correct behavior, which is to insert the text from the TextEdit 
into the menu, followed by a separator, when the contents of the 
TextEdit do not match any of the menu values. 

The example method produces the window shown in 
Figure 6. 
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Figure 6. A Type-In Pop-Up Menu Control. 
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Listing: MacTypeInPopUpProxy.st 


‘From VisualWorks(R) VanGogh beta release 1 of January 1996 on 
March 5, 1996 at 11:07:50 am’! 


MacComponentProxy subclass: #MacTypeInPopUpProxy 
instanceVariableNames: ‘control inputField items ‘ 
classVariableNames: 
poolDictionaries: 
category: ‘Mac PlatPok-Examples’! 

MacTypeInPopUpProxy comment: 

‘This class implements a Type-In Pop-Up Menu, which consists of a TextEdit and a 

PopUpMenu Control. It is described in detail in Macintosh Human Interface Guidelines, 

pages 91-92. 

Although it is documented, the Macintosh does not provide a single control which 

implements this behaviour. Therefore this class implements it by holding on to a 

MacTextEdit and a MacPopUpMenuProxy. 

This class is an example, and only implements the behaviour. A real proxy would 

provide event notification and data accessing so a client could do something when the 

value changes. 


Instance Variables 
control: a MacPopUpMenuProxy 
inputField: a MacTextEdit 
items: for speed we store the menu items’! 


!MacTypeInPopUpProxy methodsFor: ‘instance creation’! 





createBounds:items:initialSelection: 
Create the menu and input fieldsubcomponents and set the initial values. Adjust the 
bounds as appropriate for each subcomponent. 


createBounds: bounds items: aSet initialSelection: anInteger 
“Create a Type-In PopUpMenu Control with the given values.” 
“Create my components” 
self createMenuControl: (self menuBoundsFrom: bounds) ; 

createTextControl: (self inputFieldBoundsFrom: bounds). 

“Cache the items, then insert them into the menu” 
items := aSet. 
items do: [:item | 


control menu append: item asPascalString] . 


“Set the input field to the initial selection” 
inputField setText: (aSet at: anInteger)! |! 


!MacTypeInPopUpProxy methodsFor: ‘component creation’! 
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createMenuControl: 
Use the appropriate creator object to make a pop-up menu control 


createMenuControl: bounds 
“Create my menu and configure it appropriately” 
control := (MacPopUpMenuProxy creatorClass new) 
smalltalkWindowClass: MacPopUpMenuProxy; 


clientBounds: bounds; 
window: self window; 








createWindow! 
createTextControl: 
Use the appropriate creator object to make a text edit object 
createTextControl: bounds 
“Create my input field and configure it appropriately” 
inputField := (MacTextEditProxy creatorClass new) 


clientBounds: bounds; 
styledText: false; 
window: self window; 
createWindow! ! 


!MacTypeInPopUpProxy methodsFor: ‘bounds utilities’! 








inputFieldBounds: 


Adjust aBounds to allow space for a pop-up menu button on the right side 
inputFieldBoundsFrom: aBounds 

“Answer a bounds rectangle for the input field” 

‘“(aBounds copy) 


right: aBounds right - Host api kMenuWidth - 1; 
bottom: aBounds top + Host api kMenuHeight! 








menuBoundsFrom: 


Adjust aBounds to put the pop-up menu button on its right side 
menuBoundsFrom: aBounds 
“Answer a bounds rectangle for the popup button” 
‘(aBounds copy) 


left: aBounds right - Host api kMenuWidth; 
bottom: aBounds top + Host api kMenuHeight! ! 


!MacTypeInPopUpProxy methodsFor: ‘event processing’! 








activateEvt: 
Handle an activate event by forwarding the event to the subcomponents 
activateEvt: theEvent 
“Dispatch the events to my components” 
control activateEvt: theEvent. 
inputField activateEvt: theEvent! 
mouseDown: 


Let the window handle non-content area events. standardMouseDown: answers true if 
it handled the event - if false, handle it in mouseDownInContent:, below. 


mouseDown: theEvent 
“Handle a mouse down event in my window” 
“The standardMouseDown: method handles everything but inContent” 


(self window standardMouseDown: theEvent) ifFalse: [ 
self mouseDownInContent: theEvent]! 





mouseDownInContent: 


Find the subcomponent that was hit. If it was the menu, handle it in 
mouseDownInMenu:, if not, let the input field proxy do its default event processing. 
mouseDownInContent: theEvent 
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“Handle a mouse down event in my window’s content” 
| thePoint eventDetails | 


“Find the child which was hit. eventDetails contains the control object and the part 
code, or nil” 

eventDetails := self window findChild: theEvent local. 

eventDetails isNil ifTrue: [*nil]. 


“Send the event to the appropriate component” 
eventDetails proxy = control ifTrue: | 
self mouseDownInMenu: theEvent] 
iiheless | 
inputField mouseDown: theEvent details: eventDetails]! 





mouseDownInMenu: 
If the input field contains something other than what is in the menu, add its contents to 
the menu as specified in the Human Interface Guidelines 


mouseDownInMenu: theEvent 
“Handle a mouse down event in my menu” 
| match thePoint | 


“Add the input field text if it’s not in the menu’ 

(match := items includes: inputField getText) ifFalse: [ 
control menu insert: inputField getText. 
control menu insert: Host api menuSeparator. 


“Track the control. If a menu item is selected, put its value into the input field” 
(control track: theEvent local) > 0 ifTrue: 
inputField setText: (control menu getItemText: control 
getValue) ]. 


“Remove the extra items, so the menu only has them during mouse processing” 
match ifFalse: [ 


control menu deletelItem: 1; 
deleteItem: 1]]! ! 


MacTypeInPopUpProxy class 
instanceVariableNames: ‘’! 


!MacTypeInPopUpProxy class methodsFor: ‘instance creation’! 





newOnWindow:bounds:items:initialSelection: 
Create a new proxy and set its initial values 


newOnWindow: aWindow bounds: aBounds items: aSet 
initialSelection: anInteger 


“Create and return a new proxy” 
‘(self new) 
window: aWindow; 
createBounds: aBounds items: aSet initialSelection: 
anInteger; 
yourself! ! 


!MacTypeInPopUpProxy class methodsFor: ‘examples’! 





example 
Create a window proxy which contains a type-in pop-up proxy. Register interest in the 
events we need to handle. Since this window has only one input field, we can have the 
keyboard events sent directly to the input field. The only event which requires special 
handling is mouseDown, because we have to set up the menu if the text has changed. 
Otherwise we could let the window handle all events. 


example 


“Demonstrate a Type-In PopUpMenu Control” 
“MacTypelInPopUpProxy example” 


| windowProxy proxy | 

“Use a window creator to make a window proxy” 

windowProxy := (MacWindowProxy creatorClass new) 
clientBounds: (50@50 extent: 180@100); 
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title: ‘PopUp Example’; 
createWindow. 


“Create a Type-In Pop-Up proxy on the windowProxy” 
controlProxy := self newOnWindow: windowProxy 
bounds: (10@10 extent: 100@19) 
items: #(‘Seagoon’ ‘Eccles’ ‘Moriarty’ ‘Henry’ ‘Min’ 
‘Bluebottle’ ) 
initialSelection: 2. 


“Register events which the proxy will handle” 
windowProxy 
forwardEvents: #( 
mouseDown) 
to: controlProxy. 


“Register events which only the text field needs to handle” 
windowProxy 
forwardEvents: #( 
keyDown 
autoKey 
nullEvent) 
to: controlProxy inputField. 


“Register events which the window can handle” 
windowProxy 
forwardEvents: #( 
activateEvt 
updateEvt) 
to: windowProxy. 


windowProxy show. 


‘windowProxy! ! 
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PROGRAMNMER’S 
CHALLENGE 





By Bob Boonstra, Westford, MA 


HEX 
This month features another round-robin tournament 

competition, this time with the game of Hex. You might have 
encountered Hex through one of Marvin Gardner’s columns in 
Scientific American. The game is played on an NxN rhombus of 
hexagons, with one player attempting to occupy an unbroken 
chain of hexagons connecting the top and the bottom, and the 
other player the left with the right. Players alternate occupying 
hexagons, and the first to complete an unbroken chain is the 
winner. The prototype for the code you should write is: 
Boolean /*legalMove*/ Hex ( 

long boardSize, /* number of rows/columns in the game board */ 

long oppRow, /* row where opponent last moved, 0) .. boardSize-1 */ 

long oppCol, /* column where opponent last moved, 0) .. boardSize-1 */ 

long *moveRow, /* return your move - row, 0 .. boardSize-1 */ 

long *moveCol, /* return your move - column, 0) .. boardSize-1 */ 

void *privStorage, /* preallocated storage for your use */ 


Boolean newGame, /* TRUE if this is your first move in a new game */ 
Boolean playFirst /* TRUE if you play first (vertically) */ 


For your first move, Hex will be called with newGame set to 
TRUE. The size of the board, a number between 8 and 64, 
inclusive, will be provided in boardSize. If playFirst is TRUE, your 
objective is to form a vertical connection across the rows of the 
board, and you make the first move. Otherwise you are playing 
second and the objective is to form a horizontal connection across 
the columns. Your code and the code of an opponent will alternate 
play. Your opponent’s move will be provided in (oppRow, oppCol), 
which will be set to (-1, -1) if you are moving first. When your code 
is called, you should evaulate your opponents move, calculate 
your own move, and store it in (*moveRow, *moveCol). If for any 
reason you believe your opponent has moved into an occupied 
hexagon, Hex should return a legalMove value of FALSE, 
otherwise it should return TRUE. 





THE RULES 





A key to winning at Hex is to form “2-bridges” of hexagons 
that can be connected regardless of what move your opponent 
makes. For example, examine this 9x9 board, with the 
horizontal (“H”) player to move: 


01234567 8 


0 ; _— 
1 — e Vg 
2 i ee V 
3 a a oe 
. pile, 6 ve. 4 Oh 
5 VHHHV. 
6 ee ee oe 
/ ica Rares ol 
are. 4 


In this example, V can force a win. H can block one of the 
(row,col) positions (6,2) or (6,5), but not both. If, for example, H 
occupies (6,2), then V can occupy (6,5), with a guaranteed “2- 
bridge” connection to (7,3) via (6,4) or (7,4). A similar bridge exists if 
H occupies (6,5). V is therefore unstoppable from this position. 

For some additional strategy, see 
<http://www.daimi.aau.dk/~tusk/pbmserv/hex/hex.fag.htmI>. or 
<http://www.cs.cmu.edu/People/hde/hex/hexfaq>. There is a “proof” 
that the -first player can always win, but the proof is a 
nonconstructive proof by counterexample that does not divulge 
the winning strategy. 

Your code will be provided with 1MB of preallocated 
storage pointed to by privStorage. This storage will be 
preinitialized to zero before your first move and will persist 
between moves. You should not allocate any additional 
dynamic storage beyond that provided by privStorage. Small 
amounts of static storage are permitted. 




















Here’s how it works: each month we present a new programming 
challenge. First, write some code that solves the challenge. Second, optimize 
your code (a lot). Then, submit your solution to MacTech Magazine. We 
choose a winner based on code correctness, speed, size, and elegance (in 
that order of importance) as well as the submission date. In the event of 
multiple equally desirable solutions, we’ll choose one winner (with 
honorable mention, but no prize, given to the runner up). The prize for each 
month’s best solution is a $100 credit for Developer Depot™. 

Unless stated otherwise in the problem statement, the following rules apply: 
All solutions must be in ANSI compatible C or C++, or in Pascal, We disqualify 
entries with any assembly in them (except for challenges specifically stating 
otherwise.) You may call any Macintosh Toolbox routine (e.g., it doesn’t matter if 
you use NewPtr instead of malloc). We compile all entries into native PowerPC 
code with compiler options set to enable all available speed optimizations. The 
development environment to be used for selecting the winner will be stated in the 
problem. Limit your code to 60 characters per line or compress and binhex the 
solution; this helps with e-mail gateways and page layout. 


We publish the solution and winners for each month’s Programmer's 
Challenge three months later. All submissions must be received by the 1st day 
of the month printed on the front cover of this issue. 

You can get a head start on the Challenge by reading the Programmer's 
Challenge mailing list. It will be posted to the list on or before the 12th of the 
preceding month. To join, send an email to listserv@listmail.xplain.com with 
the subject “subscribe challenge-A”. 

Mark solutions “Attn: Programmer’s Challenge Solution” and send it by 
e-mail to one of the Programmer’s Challenge addresses in the “How to 
Communicate With Us” section on page 2 of this issue. Include the solution, 
all related files, and your contact info. 

MacTech Magazine reserves the right to publish any solution entered in 
the Programmer’s Challenge. Authors grant MacTech Magazine the exclusive 
right to publish entries without limitation upon submission of each entry. 
Authors retain copyrights for the code. 
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The Challenge will be scored by a tournament where each 
entry plays against each other entry twice for each of a number 
of board sizes, once playing first and once playing second. 
Another fair tournament schedule might be used if a large 
number of entries are received. For each game, the winner will 
earn game points for the victory, minus an amount based on 
the execution time used to compute the moves, as follows: 


game points = 10 - (execution time in seconds)/ boardSize 


The loser will earn zero points and will not be penalized for 
the execution time expended in defeat. The player with the most 
total points for all games in the tournament will be the winner. 

This will be a native PowerPC Challenge, using the 
latest CodeWarrior environment. Solutions may be coded in 
C, C++, or Pascal. 


THREE MONTHS AGO WINNER 

The December Tangram Challenge was a difficult one, so 
difficult that no entries were submitted by the Challenge 
deadline. Three people (Alan Hart, Ernst Munter, and George 
Warner) responded with entries after I notified the 
Programmer’s Challenge mailing list of a one-week extension, 
but none of those entries passed my test cases. AS a result, there 
is no winner for the Challenge this month. 

The problem was to reassemble a two-dimensional shape 
that has been cut into a number of smaller shapes. Each piece 
was to be transformed to its correct position by optionally 
flipping it about a vertical axis, rotating it, and translating it, in 
that order. A simple tangram can be created by curring a square 
into five right triangles of three different sizes, a smaller square, 
and a thomboid. The problem statement also allowed for zero or 
more holes in the assembled shape, a fact which complicated 
the problem significantly. The submitted solutions all had 
problems with shapes that did not include holes, and I was 
unable to select one as being more correct than the rest. I have 
awarded 4 contest points to each of the entrants for their efforts, 
and selected one of them for publication. 

Dave Bayer wrote to point out that the Tangram Challenge is 
theoretically as well as practically difficult, in that it is one of a 
class of problems called “NP-hard”. The conjecture is that these 
problems cannot be solved in time that is a polynomial function 
of the problem size, and the problems in this class are equivalent 
in the sense that a polynomial time solution for one of them 
would provide a solution for the others. The best known 
problem in this class is the traveling salesperson problem. 

To demonstrate that the Tangram Challenge is NP-hard, 
Dave transforms another NP-hard problem, the Partition 
Problem, into a tangram. The partition problem is to determine, 
given a sequence of integers ib it, ik whether there exists a 
subset whose sum is exactly half of the sum of the entire 
sequence. For example, given the sequence 
4,.4,5,7,9,11,14,14,14,18, which sums to 100, the Partition 
Problem would be to find a subset (e.g., 4,7,11,14,14) that sums 
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to 50. Dave converts the sequence into a tangram with one hole 
by constructing pieces of a rod whose length is a number from 
the Partition Problem sequence, marking one half the length of 
the rod with a hole in the tangram. The tangram would be 
constructed with 3xN pieces, where N is in the sequence. Using 
the shorter sequence 1,2,3 to illustrate this, the tangram would be 
as follows: 


XXX XXXXXX XXXXXXXXX XXXXXXXXXXXXXXXXXXX 
XXX XXXXXX XXXXXXXXX XXXXXXXXX XXXXXXXXX 
XXX XXXXXX XXXXXXXXX XXXXXXXXXXXXXXXXXXX 
1 2 3 assembled into 1 oe og a 


This construction shows that a solution to the Partition 
Problem would solve this tangram puzzle, and conversely, which 
demonstrates that the tangram problem is NP-hard. Readers 
interested in complexity theory can refer to Computers and 
Intractability, a Guide to the Theory of NP-Completeness, by 
Garey and Johnson, or to Introduction to Automata Theory, 
Languages, and Computation, by Hopcroft and Ullman. Thanks 
to Dave Bayer for these insights, and also for suggesting this 
month’s Hex Challenge. 


TOP 20 CONTESTANTS 
Here are the Top Contestants for the Programmer's Challenge. 
The numbers below include points awarded over the 24 most recent 
contests, including points earned by this month’s entrants. 





Rank Name Points Rank Name Points 
1. Munter, Ernst 18911. Cutts, Kevin 21 
2. Gregg, Xan 114 12. Nicolle, Ludovic 21 

Bo ans Gusay a7 a eae Ce 
4. Lengyel, Eric 40 14. Brown, Jorg 20 
5. Lewis, Peter — Ae 15. Gundrum, Eric 20 

See aT MN CRESTS Wa 
7. Cooper, Greg Ze 17. Karsh, Bill 19° 
8. Antoniewicz, Andy 24 18. Mallett, Jeff 17 
9. Beith, Gary 24 19. Nevard,John ~—«17 

10. Kasparian, Raffi ae 20. Hart, Alan 14 


There are three ways to earn points: (1) scoring in the top 5 
of any Challenge, (2) being the first person to find a bug in a 
published winning solution or, (3) being the first person to 
suggest a Challenge that I use. The points you can win are: 


Ist place ........ 20 points 
2nd place.......10 points 
3td place........ 7 points 
4th place........ 4 points 


UAC e..cn. canaries 2 points 
nding DUS? ccm 2 points 
suggesting Challenge ...2 points 
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Here is Alan Hart’s solution: 


Tangrams.cp © 1996 Alan Hart 


he 
NOTES 


1. Translate all the Polygons into relative vector sequences 
to do the manipulations and tests. 
Once we have a solution, convert the final positions back into 
transformations for return to the caller. 


2. Holes are almost the same as pieces. Exceptions: 
- We don’t need to return their transformations - They probably can’t be flipped, 
- They probably can’t lie along the edges of the shape. 


3. The process will be recursive trial and error: 


Where pieces are used, Holes can also be included in the process, 
taking into account that they can’t be flipped or deployed at the edge of the shape. 


- Put the first vertex of the first piece at the first vertex of the shape. 
- Align the first side of the piece with the first side of the shape. 
- If the piece is not entirely inside the shape, try the piece’s next vertex. 
- If the piece is inside the shape modify the shape to remove the piece 
and recurse to try to place the remaining pieces. 
- If the pieces are placed successfully, return 
- When all vertices of the piece have been tried unsuccesfully, flip it and repeat 
- When both flips of the piece have been tried, 
move it to the next vertex of the shape and repeat 
- When all vertices of the shape have been tried, flip the shape and repeat 


4. We need a slick procedure for testing whether one polygon lies entirely inside another. */ 
#tinclude “Tangrams.h” 


void SolveTangram( 
MyPolygon *theShape, 
long numHoles, 
MyPolygon *theHoles[], 
long numPieces, 
MyPolygon *thePieces[], 
MyTransform*theXForns [] 


~S 
= 


Initialise the Tangram instance */ 

TTangram theTShape; 

theTShape.ITangram (theShape, 
numHoles, theHoles, 
numPieces, thePieces, 
theXForms) ; 


* 


/* Fill The Shape */ 


theTShape.solve(); 


return; 


TTANGRAM.CP 
/* Class TTangram methods */ 


#include “Tangrams.h” 


#tinclude “Debug.h” 


TTangram::TTangram () 
( 
XForms "= 0: 


} 


TTangram::TTangram (TTangram& aShape) 
unplaced 
placed = 
xForms = 


= aShape.unplaced; 
aShape.placed; 
aShape.xForms; 
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void TTangram::ITangram (MyPolygon *theShape, 
long numHoles, MyPolygon *theHoles[], 


long numPieces, MyPolygon *thePieces|[], 


MyTransform*theXForms[] ) 
long i; 
TPiece *aPiece; 


m 


TShape *aHole; 
IPolygon (theShape) ; 


for (i = 0; i < numPieces; itt) 





aPiece = new TPiece; 

if (aPiece) 

if 

\ 
aPiece->»IPiece (thePieces, i); 
unplaced.insert (aPiece); 

| 

J 

else 
MyError(“\pCan’t make a Piece”); 


for (i = 0; i < numHoles; itt) 
f 
\ 


aHole = new TShape; 

if (aHole) 

f 

\ 
aHole->IShape (theHoles|i]); 
unplaced.insert (aHole) ; 

| 

J 

else 
MyError(“\pCan’t make a Hole”); 


\ 
J 


xForms = theXForms; 


| 
J 


void TTangram::solve (void) 
f 


L 


fill (&unplaced, &placed) ; 


/* Get the transform for each piece */ 
TShape *aPiece = (TShape *)placed.first(); 
while (aPiece) 
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/* Leave out the Holes */ 
if (aPiece->canFlip()) 
aPiece->getTransform (xForms) ; 
aPiece = (TShape *)placed.next(aPiece) ; 


TPOLYGON.CP 
/* TPolygon Class methods */ 


include “Tangrams.h” 
#include “Debug.h” 


include <QuickDraw.h> 
TPolygon::TPolygon () {3} 


TPolygon::TPolygon (TPolygoné& p) 
*(TVactor *)this = p; 
sides. IList(p.sides) ; 


void TPolygon::IPolygon (TPolygon *p) 
( 

*(TVector *)this = *p; 

sides. IList(p->sides) ; 


void TPolygon::IPolygon (MyPolygon *theData) 
/* Create a TPolygon using cartesian input data */ 

long i; 

TVector *aSide, previousSide; 


/* The origin defines the vector position 
of the first vertex relative to the origin and the h=0 axis */ 
setHV (theData->vertex[0].h, theData->vertex[0].v); 
for (i = 0; i < theData->numVertices ; it+) 
{ 
aSide = new TVector; 
if (!aSide) 


MyError(“\pIPolygon: Failed to create a new side vector”); 


sides.insert (aSide) ; 
/* Convert each vertex to a vector from the previous vertex */ 
if (i == theData->numVertices -1) 


e Special pricing for Absoft & LS Fortran users 
aig f ‘ e Visit http://www.absoft.com for complete details 





development tools and languages 
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absoft.com 


/* The last vector is relative to the origin */ 
aSide->setHV (theData->vertex[0].h 
- theData->vertex[i].h, 
theData->vertex[0].v - theData->vertex[i].v); 
else 
aSide->setHV (theData->vertex[itl].h 
- theData- >vertex[i].h, 
theData->vertex|[itl].v - theData->vertex[i].v); 
} 
} 


/* Access */ 
TVector TPolygon::getOrigin (void) 
return *this; 


TVector* TPolygon::firstSide (void) 
{ 


return sides.first(); 
} 


TVector* TPolygon::nextSide (TVector *aSide) 


TVector *v = sides.next(aSide) ; 
if (v) 

return v; 
else 

return sides.first(): 


TVector* TPolygon::lastSide (void) 
( 


return sides.last(): 


float TPolygon::getRotation (void) 
{ 

return sides.first() ->getAngle(); 
} 


void TPolygon::rotate (float anAngle) 
{ 


TVector ‘*theSide, *firstSide: 


Want to share a tip with the 


community and get paid for it? 
Send it in to 


<mailto:tips@mactech.com> 
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firstSide = sides. first(); 
4f (firetSide) 
{ 


theSide = firstSide; 
do { 
theSide->rotate(anAngle) ; 
theSide = sides.next(theSide)::; 
} while (theSide) ; 
} 
} 


void TPolygon::translateTo (TVector *where) 
( 


if (where) 


*(TVector *)this = *where; 
} 
else 
set(0,1): 
} 


void TPolygon::rotateTo (float direction) 


rotate (direction - getRotation()); 


Boolean TPolygon::fill (TList *unplaced, TList *placed) 
{ 

Boolean result = false; 

TShape *thePiece, *previousPiece = 0; 

TPolygon *newSpace; 


thePiece = (TShape *)unplaced->first(); 
if (thePiece) 
( 

do { /* Try all unplaced pieces */ 


/" Transfer the current piece to the placed list */ 
unplaced->remove (thePiece) ; 
placed->insert (thePiece) ; 


/" Align thePiece with the first side of the Shape */ 
align(thePiece) ; 
do { /* Try each flip state */ 
do { /* Try all orientations */ 
if (this->contains (thePiece)) 
{ 
/* Copy the Shape */ 
newSpace = new TPolygon (*this); 
/* Modify the copy to remove the area of thePiece. */ 
newSpace-Ysubtract (thePiece) ; 
/* Try to place remaining pieces in this shape. */ 
result = newSpace->fill (unplaced, placed); 


* 


/* Discard the modified shape. */ 


delete newSpace; 


if (result) return true; 
} 
} while (thePiece->turn()); 
} while (thePiece->flip()); 


/* Move the current piece back to the unplaced list*/ 
placed->remove (thePiece); 
unplaced->insert (thePiece, previousPiece) ; 


/* Next unplaced piece */ 
previousPiece = thePiece; 
thePiece = (TShape *)unplaced->next (thePiece) ; 
} while (!result && thePiece) ; 
} 
else 
/* No pieces left to place - job done */ 
result = true; 
return result; 
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void TPolygon::align (TPolygon *p) 


p->translateTo(this) ; 
p-ProtateTo (getRotation()); 


void TPolygon::subtract (TPolygon *thePiece) 
{ 
TVector *firstPieceSide, *pieceSide, 
*firstShapeSide, *shapeSide, 
*aSide, difference; 


/* The origins of the Shape and thePiece should be congruent */ 


Assert (TVector(*this) == thePiece->getOrigin(), 
“\pSubtract: thePiece is not placed at the origin of 
the Shape”); 


/* Start at the first sides */ 
firstPieceSide = pieceSide = thePiece->firstSide() ; 
firstShapeSide = shapeSide = firstSide() ; 


/* Calculate the difference */ 
/* Delete all consecutive sides of the shape that are 
congruent with sides of aPiece. */ 
do { 
difference = *shapeSide; 
difference -= *pieceSide; 
if (difference.getLength() == 0) 
{ 
/* These sides are congruent */ 
*this += *shapeSide; 
aSide = shapeSide; 
shapeSide = nextSide(aSide) ; 
sides.remove (aSide); 
delete aSide; 
pieceSide = thePiece->nextSide(pieceSide) ; 
if (pieceSide == firstPieceSide) 
/* We've gone right round thePiece 
All piece sides congruent. 
We have filled an enclosed space in the shape. 
So just return */ 
return; 
} 
else if (*shapeSide || *pieceSide) 
/* The next sides are parallel 
Loop to check if they are equal */ 
else 
/* The next sides are not concurrent */ 
break; 
else 
{ 
/* These sides are concurrent but have different lengths 
Reduce the shape side to the length and direction of the residue, 
put the origin here, and move to the next piece side */ 
*shapeSide = difference; 
*this t= *pieceSide; 
Entrada! dtF is fully OpenDoc™ compatible. With its 
direct integration technology, dtF is fully contained in your 
application, there is no need for separate drivers, INITs or background 
processes. Standalone applications built with dtF are royalty-free. dtF 
} while (true); is fully CD-ROMable and has modest runtime requirements, making it 
an ideal choice for Powerbook or Multimedia applications. dtF sup- 
ports cross-platform development on Windows 3.11, 95, NT and OS/2 


with an identical API across all platforms. 


dtk The Relational 
Database System 


pieceSide = thePiece->nextSide(pieceSide) ; 
break; 


/* pieceSide is the first non-congruent side of thePiece. 
Make a new list of the rest of the pieceSides in reverse order */ 


TList *newSides = new TList(); 
while (pieceSide != thePiece->firstSide()) 


{ 
aSide = new TVector(*pieceSide) ; 
newSides->insert(aSide, 0); 
pieceSide = thePiece->nextSide(pieceSide) ; 


dtF Americas, Inc. 


19672 Stevens Creek Blvd., Phone: (800) DTF-1790 
Suite 128 Fax: (510) 828-8755 


Cupertino, CA 95014, USA __ Internet: dtF @interramp.com 
http://www.thetagroup.ilk.de 
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/* Scan the list of newSides 
and compare them with the last sides of the shape. 
Eliminate duplicated or concurrent sides */ 
pieceSide = newSides->first(); 
while (pieceSide) 
{ 
shapeSide = lastSide(); 
if (*pieceSide == *shapeSide) 
/* Sides are congruent so remove from the shape and loop */ 
sides.remove (shapeSide) ; 
else if (*pieceSide || *shapeSide) 
{ 
/* Sides are parallel but different lengths */ 
shapeSide->setLength (shapeSide->getLength() 
- pieceSide->getLength()); 
pieceSide = newSides->next (pieceSide) ; 
break; 
} 
else 
break; 
pieceSide = newSides->next (pieceSide) ; 
} 
/* Reverse the rest of the pieceSides and append to the shape */ 
while (pieceSide) 
{ 
newSides->remove (pieceSide) ; 
shapeSide = (TVector *)newSides->next (pieceSide) ; 
sides.insert (pieceSide) ; 
pieceSide->reverse() ; 
pieceSide = shapeSide; 
} 
/* Destroy the temporary List */ 
delete newSides; 
} 


Boolean TPolygon::contains (TPolygon *p) 
{ 
/* Test if *this contains (is wholly outside) p */ 

Boolean result = true; 

TVector “Trside, “rirstinside, 
*outside, *firstOutside, 
Qutatart, Instart, relative; 

// minAngle, maxAngle; 


inStart = p-?>getOrigin(); 
inside = tirstingside = p--Tirstoidet)- 
do { /* for each side of *p */ 
outStart = (TVector)*this; f 
outside = firstOutside = firstSide(); : 
hs relative = outStart; 
relative -= inStart; 
minAngle = maxAngle = relative; */ 
do /* for each side of *this */ 
{ 
/* Check if sides of *p and *this intersect */ 
if (*inside || *outside) 
/* Parallel lines don’t intersect */ 


else if (Intercept (&inStart, inside, &outStart, outside)) 
{ 
/* These sides intersect */ 
result. = false: 
break; 
} 


* 


/* update the subtended angles 
relative += *outside; 
if (relative > maxAngle) maxAngle = relative; 


else if (relative < minAngle) minAngle = relative; */ 


* 


/* next side of *this */ 
outStart t= ‘outside; 
outside = nextSide (outside); 


} while (outside != firstOutside); 


if (!result) break; 
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/* If max and min subtended angles are not parallel 
the start point of *p side is outside *this 
if (\(maxAngle || minAngle)) 
{ 
result = false; 
break; 


/* next side of *p */ 

inotare t= “ineide*s 

inside = p->nextSide (inside) ; 
} while (inside != firstInside); 


return result; 


TLIST.cP 
/* TList Class Methods */ 


/* TList implements a singly-linked List of pointers 
The TList has pointers to the start and end nodes. 
Each node has a pointer to the next TVector in the list 


start —> nodel — node2 ->.... 
|-> nodeN —> 0 
end — 


New nodes are added by inserting them after a specific node 
using insert (TVector *aVector, TVector *afterVector) 
or by adding them after the end node using insert (TVector *aVector). */ 


#include “Tangrams.h” 


TList?? Thiet) 
{ 
Stare 
end = 


= 0; 
0; 


void Thist?+ (hist (iLists. alast) 
{ 
T¥Vector “vil, “v2: 
Vi. = alist starr: 
while (vl) { 
v2 = new TVector (*vl): 
insert(v2):; 
vl = vl->next; 
} 
return; 


TList: -“TList() 
{ 


T¥ector “nl, *n2: 


hl = stare 

while (nl != 0) 

{ 
n2 = nl->next; 
delete nl; 
nl = n2: 

} 

} 


void TLhist:<ineert (TVector *avector) 
{ 
/* Append TVector as the last item in the list */ 
if (end) 
insert (aVector, end); 
else 
{ 
aVector->next = 0: 
start = end = aVector; 
} 
} 
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The Law Office of Bradley M. Sniderman 


California Lawyer focusing on Intellectual 
Property, Corporate, Commercial and Contract 
law, as well as Wills and Trusts. 


If you are looking to protect your software with 
Copyright or Trademark protection, or if you need 
help establishing or maintaining your business, 
please give me a call or an e-mail. Reasonable fees. 


(310) 553-4054 
Brad@Sniderman.com 


MacTech Magazine is your 
recruitment vehicle 


When you need to fill important positions at your company, MacTech 
Magazine is the consistent choice of companies across the country for 
hiring the best qualified Macintosh programmers and developers. Let 
MacTech Magazine deliver your recruit-ment message to an audience 
of over 27,000 qualified computer professionals. 


Call Ruth Subrin at 
805/494-9797 
























Mac Registry” 
Developer Job Opportunities 


If you are a Macintosh developer, you should register with us! 
We have a database that enables us to let you know about job 
opportunities. When we are asked to do a search by a client 
company the database is the first place we go. There is no 
charge for registering. The database service is free. Geo- 
graphic Coverage is nationwide. 


Marketability Assessment - To get a specific feel for your 
marketability send a resumé via Email or call. You may also 
request a Resume Workbook & Career Planner. 


Discreet - We are very careful to protect the confidentiality of 
a currently employed developer. 


Scientific Placement is managed by graduate engineers, we 
enjoy a reputation for competent & professional job place- 
ment services and we are Mac fanatics. 


1-800-231-5920 + das@spi.com * Fax 1-800-757-9003 
http://www.scientific.com 


Scientific Placement, Inc. 


MT, Box 19949, Houston, TX 77224, 281-496-6100 Fax: 281-496-0373 
MT, Box 71, San Ramon, CA 94583 510-733-6168 beth@spica.bdt.com 
MT, Box 202676, Austin, TX 78720-2676 512-260-0123 lej@zilker.net; 
Compuserve: 712503001; AOL: davesmall 











Hewp MAKE MAcTecH Work 


Here at MacTech Magazine, we rely heavily 
on outside writers for most of the material that 
appears in our pages. If readers did not 
participate in the magazine, sending us their 
ideas and taking the time to write articles, there 
would be no MacTech. MacTech Magazine is 
not a staff of writers sending a constant stream 
of one-way messages outwards; it’s a living, 
evolving network of readers conversing with 
one another, educating one another, sharing 
their knowledge, their experience, their 
interest, their trials and tribulations and joys 
and successes in the constantly unfolding story 
of programming the Macintosh. MacTech 
Magazine doesn’t just happen: it’s what the 
community makes it. If we carry reports of 
future trends and technologies, if we teach 
useful methods, if we review new books and 


MarcH 1997 @© MACTECHMAGAZINE 


tools, if we provoke thought, provide help, 
ride the wave of current interests and 
concerns, it is only because we reflect the 
thoughts of our readers, who speak through 
our pages. 

You are invited to involve yourself in 
this exciting conversation amongst readers. 
No matter who you are, no matter what your 
credentials may be, if you have a tale to tell, 
a trick to share, a technique to teach, we 
want you to consider joining the family of 
those who write for MacTech. 

Don’t just wait for a topic to be 
covered or a technique explained in 
MacTech! Take responsibility! Write us an 
article yourself! 

To write for MacTech, just send for our 
Writer's Kit. It’s a Microsoft Word file 


containing the Styles you need to use, and 
giving lots of helpful advice and information, 
including all the legal stuff. You can let us 
know what you’re writing about, or, if you 
want to, you can just write the article and 
spring it on us when it’s done. [Note: We 
also have a need for people willing to make 
themselves available to write occasional 
product/book reviews.] If we publish your 
article, you'll be paid for it! 

Write to us, the editorial staff, at 
editorial@mactech.com (or one of the other 
addresses listed on page 2 of the magazine). 
Take the future of MacTech Magazine into 
your own hands! 


For Macintosh 
Programmers & Developers 
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Wold Thist?:insert (TVector “aVector,. TVector “atterVector) 


{ 
/* Insert TVector after afterVector */ 
if (afterVector) 
{ 
aVector-?>next = afterVector-?next; 
afterVector->next = aVector; 
} 
else 
{ 
aVector->next = start; 
start = aVector: 
} 
if (end == afterVector) 
end = aVector; 
} 
void TList::remove (TVector *aVector) 
{ 
if (start) 
{ 
if (aVector == start) 
{ 
start = start->next; 
if (end == aVector) 
end = 0; 
} 
else 
{ 
TVector* n = start: 
while (n) 
{ 
if (n->next == aVector) 
{ 


n->next = aVector->next; 


if (aVector == end) 
end =n; 
break; 
} 
else 


n = n->next: 


Want to subscribe 
to MacTech Magazine? 
Contact 


<mailto:orders@devdepot.com> 


call 800-MACDEV-1 
or 805-494-9797, 
or fax 


805-494-9798. 
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Tyecror® Thiste:firer [yvoid) 
{ 
return start: 


TVector* TList::next (TVector *aVector) 
{ 
/* Return the next node in the list. */ 

return aVector->next; 


TVector® Tlists:last. (void) 
{ 
return end; 


Boolean TList::valid (TVector *aVector) 
{ 
TVector ‘*n; 


n = start: 
if (aVector) 
while (n) 
if (aVector == n) 
return true: 
else 


n = n->next: 
return false: 


TPIECE.CP 
/* TPiece Class Methods */ 


#tinclude “Tangrams.h” 


void TPiece::IPiece (MyPolygon *theData[], long i) 
{ 

IShape (theData[i]); 

LnGdex =a 

Pirstorigin = *thig: 

firstDirection = *firstDefinedSide; 


void TPiece::getTransform (MyTransform *theTransform[]) 


MyVertex v; 
MyTransform*tf = theTransform[index] ; 


firstOrigin.getHV (&v); 
tf->doFlip = flipped; 
if (flipped) 
tf->flipH = v.h; 
firstDirection.flip(pi/2) ; 
TirstOrigin “= firstbirection: 
} 
else 
ti-)rliph = 0; 


firstOrigin.getHV (&v); 
tf->rotateCenterH = v.h; 
tf->rotateCenterV = v.v: 


tf->rotateClockwise = firstDefinedSide->getAngle() 
firstDirection. getAngle(); 


TVector offset = getOrigin(); 
offset -= firstO0rigin: 
TVector *side = firstSide(): 
while (side != firstDefinedSide) 
{ 

offset t=. *side; 

side = nextSide (side); 
} 
offset.getHV (&v); 
tf->translateH = v.h; 
tf->translateV = v.v: 
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TSHAPE.CP 
/* TShape Class methods */ 


#include “Tangrams.h” 
#finclude “Debug.h” 


TShape: : TShape() 
flipped = false; 
} 


void TShape::IShape (MyPolygon *theData) 
{ 

IPdlygon (theData) ; 

flipped = 0; 

firstDefinedSide = firstSide(); 


Boolean TShape::flip(void) 
{ 
Boolean result = false; 


if (canFlip()) 
{ 
TVector *firstSide; 


firstSide = sides.first(); 

if (firstSide) 

{ 
float base = firstSide->getAngle(); 
TVector *theSide, *nextSide; 
theSide = sides.next(firstSide) ; 
while (theSide) { 


theSide->flip(base) ; /* Flip each subsequent side round the first */ 


nextSide = sides.next(theSide) ; 
sides.remove(theSide) ; /* and reverse its order */ 
sides.insert(theSide, firstSide); 
theSide = nextSide; 
} 
} 
result = flipped = !flipped; 
} 
return result; 


\ 
J 


Boolean TShape::turn () 
f 
l 
TVector *sl = sides.first(); 
sides.remove(sl); 
sides.insert(sl); 
TVector *s2 = sides.first(); 
rotate (sl->getAngle() - s2->getAngle()); 
return (s2 != firstDefinedSide) ; 


\ 
J 


void TShape::getTransform (MyTransform *theTransform[]) 
f 
l 

theTransform = theTransform; 


| 
J 


TVECTOR.CP 
/* TVector Class methods */ 


#include “Tangrams.h” 


/* DEFINITIONS */ 
define k_ZeroError (0.001) /* Needs to be dynamic */ 


/* TVector is a polar vector 
Angle is measured in clockwise radians 
Absolute angles are measured relative to the h=0 axis */ 


float zeroCorrect (float q); 
float zeroCorrect (float q) 


{ 
return (q > -k_ZeroError && q < k_ZeroError) ? 0: q; 


\ 
J 
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WINREZ 


Dont rewrite your apps, 


Port them! 


WinRez is a complete emulation 
of all Resource Manager and 
Memory Manager routines. 


Read/ Write/Create your rez 
forks in your Windows apps. 


String resources and rez fork 


chaining fully supported. 
WW W.PARTIUM.COM 





float angleCorrect (float q); 
float angleCorrect (float q) 


q=qt2* pi; 
return zeroCorrect (q); 


} 
TVector::TVector() 
{ 
next = 0; 
gat (0,0): 
} 
TVector::TVector(TVector& v) 


*this = v: 


TVector::TVector(float dir, float len) 





set (dir, len); 


/* Polar Vector assignment 
Only assigns direction and length */ 
TVector& TVector::operator = (TVector& aVector) 
angle = aVector.angle; 
length = aVector.length; 
return (*this); 
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| Easy to learn 
| Easy to use 
| Runs quickly 
| Needs little disk space 
| Needs little memory 
| Safer than toolbox routines 
| Not just a different look 
No royalties 


World-Class Controls 

for the Discerning Developer 

For all Macintoshes and system versions 
Full color and multi-monitor support 
680x0, PowerMac and Fat/Safe format 


The finishing touch for a complete 3D look 


t/3D text 
Y 7 buttons, 9 tabs and 11 sliders (fla ; 
flat/3D body, raised/inset title, soft/bold shadows, 


variable shapes) plus a thermometer 


ony $89° V Customizable check boxes plus undefined state 


“Free with V Sliders options: tick marks (1 side/2 sides/none), 


oo ty scale (forward/reversed/none), snap or step to 
Developer Kit mouse, smart scaling 





/* Polar Vector addition */ 
TVector& TVector::operator t= (TVector& aVector) 
| 

MyVertex pl, p2; 


getHV (&p2); 
aVector.getHV (&pl); 

b2. ho t= pik, 

p2cv =p. 

p2.h = zeroCorrect(p2.h); 
p2<V = zerolCorrect(p2.v); 
setHV (&p2); 

return (“this); 


/* Polar Vector subtraction */ 
TVector& TVector::operator -= (TVector& aVector) 
MyVertex pl, p2; 


getHV (&p2); 
aVector.getHV (&pl); 


p22 pe 
Pout = ipl 
p2.h = zeroCorrect(p2.h) ; 


p2.v = zeroCorrect(p2.v); 
setHV (&p2); 
return (*this); 


/* Polar Vector equality */ 
Boolean TVector::operator == (TVector& aVector) 
( 
if (0 == zeroCorrect (aVector.length - length)) 
if (0 == angleCorrect (aVector.angle - angle)) 
return true; 
return false; 


} 


/* Polar Vector angle compare */ 
Boolean TVector::operator > (TVector& aVector) 
{ 
if (0 != zeroCorrect (aVector.length - length)) 
if (0 < angleCorrect (aVector.angle - angle)) 
return true; 
return false; 


/* Polar Vector angle compare */ 
Boolean TVector::operator < (TVector& aVector) 
( 
if (0 != zeroCorrect (aVector.length - length)) 
if (0 < angleCorrect (aVector.angle - angle)) 
return true; 
return false; 


/* Test if parallel */ 
Boolean TVector::operator | (TVector& aVector) 
( 
float diff = angleCorrect (aVector.angle - angle); 
it (ON ae) 
return true; 
else if (0 == angleCorrect (diff + pi)) 
return true; 
else return false; 


void TVector::set (float dir, float Jen) 
{ 

angle = dir; length = len; 
} 


void TVector::setLength (float len) 
{ 
length = len; 
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void TVector::setAngle (float dir) 
{ 
angle = dir; 


void TVector::setNext (TVector *aVector) 
{ 
next = aVector; 


/* Transformation */ 
void TVector::rotate (float anAngle) 
angle += anAngle; 
if (angle > pi) 
angle -= 2*pi; 
else if (angle < -pi) 
angle t= 2*pi; 
angle = zeroCorrect (angle); 


void TVector::reverse (void) 
{ 
if (angle > 0) 
angle = zeroCorrect (angle - pi); 
else 
angle = zeroCorrect (angle + pi); 


void TVector::flip (float around) 
{ 


angle = angleCorrect (2 * around - angle); 


/* Access */ 
float TVector::getLength (void) 
{ 

return length; 


void TVector::setLength (float len) 
length = len; 


float TVector::getAngle (void) 
{ 
return angle; 


TVector* TVector::getNext (void) 
{ 
return (TVector *)next; 


/* Cartesian/Polar conversion */ 
void TVector::getHV (MyVertex *pt) 
{ 


pt->»h = zeroCorrect(length * sinf(angle)); 
= zeroCorrect(length * cosf(angle)); 


pt->v 


void TVector::setHV (MyVertex *pt) 
({ 
setHV (pt->h, pt->v); 
void TVector::setHV (float h, float v) 
if (zeroCorrect(v)) 
( 
/* |v) !=0*/ 
angle = zeroCorrect(atanf(h/v)); 
/* We have an angle between -pi/2 and pi/2 


If v < 0 we need to put the angle in the opposite quadrant */ 


if dy 46) 
if (angle < 0) 
angle t= pi; 
else 
angle -= pi; 
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else if (h < 0) 


angle = -pi/2; 
else 
angle = pi/2; 


length = sqrtf(h*th + v*v); 


/* Test for Intersection */ 
Boolean Intercept (TVector *plstart, TVector “pl, 


{ 
ba 


fr 


TVector *p2start, TVector *p2) 


plstart is the first point on the inside vector p1 
p2start is the first point on the outside vector p2 */ 


Boolean result = false; 


x1 and x2 are the start and end points of the inside vector */ 
T¥Vedtor xl = *plstart; 

TVector x2 = *pl; 

pe ae Ng 


Transform the inside vector so that the outside vector 

lies along the positive h=0 axis */ 

xl -= *p2start; /* translate inside points so that outside start point = 0,0 */ 
Ker" P2ScaTts 

xl.length = zeroCorrect (xl.length) ; 

float al = angleCorrect(xl.angle - p2->angle); /* rotate so that 


outside lies along the axis */ 


float a2 = angleCorrect(x2.angle - p2->angle); 


/* Inside can get outside by being concurrent with it and longer */ 
if (al == 0 && a2 = 0) 
if (xl.length < 0 || zeroCorrect (x2.length - p2->length) 
20) 
return true; 
/* Inside can get outside by starting at axis and going in the wrong direction */ 


if ((xl.length == 0 || al == 0) && a2 < 0) 
return true; 


Want to share a 


tip with the community 


and get paid for it? 


Send it in to 


<mailto:tips@mactech.com> 
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if ((al > 0 != a2 > 0) && MyPolygon ‘*theShape, /* shape to be assembled */ 
/* The endpoints are on opposite sides of the h=0 axis, */ long numHoles, /*number of holes in theShape (>=0) */ 
al != 0 && xl.length != 0 && MyPolygon *theHoles[], /*holes in theShape (>=0) */ 

a2 != 0 && x2.length != 0 && /*neither is on the axis, */ long numPieces, /* number of pieces in theShape */ 


MyPolygon *thePieces[], /* pieces in theShape */ 
MyTransform*theXForms[] /* transform for each piece */ 
( Nis 

float denom = ((sinf(al) * x1.length) (sinf(a2) * 


(al < pi || a2 < pi)) /*and at least one end is above the v=0 axis */ 


x2.length) ); /* INCLUDES */ 
if (denom > k_ZeroError | | denom < - k_ZeroError) 
{ finclude <math.h> 


float difi = p2->length = sinf (al - a2) * xl. length 


x2.length /denom; #define MyError(msg) ExitToShell(); 
if (diff > k_ZeroError) 
result = true; 
} class TVector 
else 
result = false; /* A vector expressed in polar coordinates */ 
} friend class TList; 
return result; protected: 


} float angle; // clockwise radians 


/* CLASSES */ 


float length; //length 
TVector ‘*next; 
DubLIC; 
DEBUG.H // Constructors 
ifndef _ DEBUG__ TVector () ; 


TVector(TVector& v); 
TVector(float dir, float len); 
// Operators 
TVector& operator = (TVector& aVector); 
TVector& operator += (TVector& aVector); 
TVector& operator -= (TVector& aVector); 
Boolean operator == (TVector& aVector); 
Boolean operator > (TVector& aVector); 
Boolean operator < (TVector& aVector); 
Boolean operator || (TVector& aVector); /* parallel */ 
// Access 
float getLength (); 
float getAngle (); 
TVector* getNext (); 
void set (float dir, float len); 
void setLength (float len); 
void setAngle (float dir); 


#fdefine __DEBUG__ 

void _Assert(const Boolean condition, ConstStr255Param msg); 
void _MyError(ConstStr255Param msg) ; | 

itifdef DEBUG 


#define Assert(c, msg) 


_Assert (c, msg); 
#tdefine MyError (msg) 


_MyError (msg); 
#felse 


#fdefine Assert(c, msg) { /*Nothing*/ } 
#tdefine MyError(msg) ExitToShell(); 


endif void setNext (TVector *aVector); 
// Transformation 
#endif void rotate (float anAngle); 
void reverse (); 
void flip (float around) ; 
// Cartesian/Polar conversion 
TANGRAM.H void setHV (float h, float v); 


void setHV (MyVertex *pt); 
void getHV (MyVertex *pt); 
// Is Intercept of the line from p1 to p2 on h=0 < distance? 
friend Boolean Intercept (TVector *plstart, TVector *pl, 
TVector *p2start, TVector *p2); 


/* Tangrams.h */ 
#pragma mark Problem Specification 


typedef struct MyVertex { 1. 
float h;/* horizontal coordinate of vertex */ 


float v;/* vertical coordinate of vertex */ alade Thiet 





} MyVertex; 
; /* A list of TVector instances */ 
#fdefine kMaxVertices 10 protected: 
TVeCtor “Start: 
typedef struct MyPolygon { TVector ‘end: 
long numVertices; /*the number of vertices*/ public: 
MyVertex vertex[kMaxVertices]; /*the vertices*/ TList(): 
} MyPolygon; ~TList(); 
void IList(TList& alist); 
typedef struct MyTransform * eaieeks . voidinsert (TVector *aVector); /*addaVector to the end */ 
es See eer ee ee voidinsert (TVector *aVector, TVector *afterVector); 
oat rotateClockwise; radians to rotate - void remove (TVector *aVector): 
float rotateCenterH; /* - around this horiz coord - */ TVector* first (void); /*return first node */ 
float rotateCenterV; /*- and this vert coord */ TVector* next (TVector *aVector): 
float translateH; /* translate this far horiz */ TVector* last (void): /retum last nile +) 
float translateV; /* translate this far vert */ 


Boolean doFlip; 


/* Flip if true */ 


} MyTransform; 
void SolveTangram( 
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Boolean valid (TVector *aVector); 
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class TPolygon : public TVector 
{ 
/* A Polygon can be rotated and translated. 


“Align” places the polygon with its first side along the first side of the input polygon 


“Rotate” turns the polygon through an angle about its origin 
“Translate” moves the polygon along a vector */ 
protected: 
TList sides; 
/* A list of Vectors defining the direction and distance 
of each vertex from its predecessor. 
The Vector in the base class stores direction and 
distance from the origin to the start point. */ 


public: 
/* Constructors */ 
TPolygon (); 
TPolygon (TPolygon& p); 
void IPolygon(TPolygon *shape) ; 
void IPolygon(MyPolygon *shape); 
/* Access */ 
TVector getOrigin (void); 
TVector* firstSide (void); 
TVector* nextSide (TVector *aSide); 
TVector* lastSide (void); 
float getRotation (void) ; 
/* Transformations */ 
void rotate (float angle) ; 
void rotateTo (float direction) ; 
voidtranslate (TVector *where) ; 
void translateTo (TVector *where) ; 


Boolean fill (TList *unplaced, TList *placed); 
Boolean contains (TPolygon *p); 
void align (TPolygon *thePiece) ; 
void subtract (TPolygon *aPiece) ; 
ie 


class TShape : public TPolygon 
{ 
/* A Shape is a Polygon used to fill a Tangram. 
It may be flipped and turned. 
It remembers its first defined side and flipped state 
“Flip” turns the shape over about the perpendicular 
bisector of its current first side 
“Turn” moves the shape so that its next side and vertex take 
the start point and direction of its current first side and vertex */ 
protected: 
Boolean flipped; 
/* Is this Shape currently flipped? */ 
TVector* firstDefinedSide; 
/* Stores a pointer to the first side */ 
public: 
TShape() ; 
void IShape (MyPolygon *theData) ; 
virtual Boolean canFlip(void) {return false; } 
/* The base class cannot be flipped and always returns false */ 
Boolean flip(void); 
/* Flip the Shape if canFlipO 
Return false if it is not now flipped. */ 
Boolean turn () 
/* Change the current first side. 
Return false if the next side is the firstDefinedSide */ 


virtual void getTransform (MyTransform *theTransform|[]); 


£- 


class TPiece : public TShape 
{ 
/* A Piece is a Shape that can really be flipped, and 
It remembers the index of the input data that defined it, 
and the direction and relative position of the first defined side for recovery 
of its transform into the MyTransform structure at that index */ 
private: 
long index; 
TVector firstOrigin; 
TVector firstDirection; 
public: 
void IPiece (MyPolygon *theData[], long i); 
virtual Boolean canFlip(void) {return true; |] 
virtual void getTransform (MyTransform *theTransform[]) ; 


Ni 
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class TTangram : public TPolygon 
{ 
/* The Tangram to solve is a Polygon that we want to fill with Shapes */ 
protected: 
TList unplaced; 
TList placed; 
MyTransform**xForms; 
public: 
TTangram (); 
TTangram (TTangram& aShape) ; 
void ITangram (MyPolygon *theShape, 
long numHoles, MyPolygon *theHoles|[], 
long numPieces, MyPolygon *thePieces|], 
MyTransform*xForms[]); 
void solve(void) ; 
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By Dave Klingler 








A Quick Take On Apple’s Purchase Of NeXT 





What are the pros and 
cons of Apple’s integration 
of NeXT technologies with 
the MacOS? 


A LATE 1996 CHRISTMAS PRESENT 
FOR THE REST OF Us 


My first reaction to the news of NeXT’s 
sale to Apple was a groan of despair. For 
those who don’t remember, Steve Jobs used 
to make having an Apple computer a roller 
coaster ride. Having anything at all to do 
with NeXT was the same way. Steve doesn’t 
believe in color, floppy disks, games or self- 
restraint when it comes to offending the 
entire computer industry. 

When I found out that Steve would be 
strictly an adviser to Amelio and Roizen, I 
breathed a cautious sigh of relief. I have met 
Steve Jobs and spoken to him twice. My 
personal reaction was that he was an 
individual of very high integrity and strong 
convictions, and I liked him a great deal. 
Steve can sometimes be right on when 
devising “insanely great” technologies. You 
can get an idea what life is like for me when 
you consider that I’m addicted to using my 
monochrome cube. Pain and pleasure all 
mixed into one. 

I think the best thing to come out of the 
deal is that Apple will get Avi Tevanian, and, 
presumably, Jean-Marie Hullot. Tevanian did 
much of the original Mach port to the NeXT 
platform, and Hullot wrote a fair portion of 
the NeXT operating system and Interface 


Builder. 'd gladly work for Apple if it meant a chance to work with 
either one of these two guys. I’ve developed a strong respect for the 
rest of NeXT’s software engineers as well. 

If Apple slashes the cost of NeXT’s products, such as the OS 
and WebObjects, I will be overjoyed. The products are superior, 
and their new lease on life would mean that I don’t have to 
switch platforms for a while longer. NeXT’s OS is arguably the 
most immediately relevant part of the deal for Mac developers, so 
I’m going to tell some of what I know about it. 


OPENSTEP’S STRENGTHS 
As most any Mac developer knows by now, Apple spent 
some time considering a number of options for the development 
of the next MacOS. These included purchase or integration of 


Objective C is far superior in many 
ways to C++. It is a true object-oriented 
language that functions sort of like a cross 
between C and Smalltalk. 


BeOS, Solaris or NeXT’s OpenStep for Mach. 

OpenStep for Mach (formerly called NeXTStep) is in many 
ways a far more elegant OS than the BeOS. It is based on the 
Mach microkernel with a BSD 4.4 personality for uNIx 
compatibility. The Display Postscript (DPS) server is tightly 
integrated into the OS just on top of the kernel, and so is 
Objective C. What makes OpenStep for Mach sort of magical is 
the sum of its parts: Mach + DPS + Objective C = an extremely 
elegant development environment. Ill refer to it from this point 
on as OpenStep, but keep in mind that the development 





Dave Klingler is a longtime NeXTStep and Macintosh developer who has a very small company called Gondolin Software in 
Albuquerque, New Mexico. He is very happy about Apple’s purchase of NeXT. You can reach him at klingler@rt66.com. 


EW A QUICK TAKE ON APPLE’S PURCHASE OF NEXT 





MACTECHMAGAZINE ®@ MARCH 1997 








environment has been decoupled from the OS and is available 
as OpenStep for Windows NT and Solaris as well. 

For those of you who might be worried about DPS’s speed, 
it’s not really an issue. NeXT and Adobe optimized the DPS 
server so well that one never sees any sort of redraw. Note that 
I said “server”; DPS is a client-server system, so you can host a 
display on a different system than the one that’s actually doing 
the drawing calculations. 

The Mach microkernel is a multiprocessor-capable 
threading OS kernel. It has been ported to almost every 
processor extant, one of those being the PowerPC. Anyone who 
does NT development will notice that the NT kernel API is 
almost identical to Mach’s, other than the Graphics Device 
Interface (NT’s GDI was recently tied into the kernel in a 
controversial move by Microsoft to make NT faster for everyday 
users, thus changing the NT kernel’s status as a microkernel.) 
MkLinux is based on Mach with a Linux personality similar to 
the BSD personality that OpenStep uses. If you’ve gotten the 
idea that Mach is very flexible, you're right. 

Objective C is superior in many ways to C++. It 1¢ a true 
object-oriented language that functions sort of like a cross 
between C and Smalltalk. You will find that Java is more similar 
to Objective C than it is to C++. The nice thing about Objective C 
in relation to OpenStep is that the runtime object server is part of 
the core OS, so you get a very high percentage of code reuse. 

As an example, I probably have in the neighborhood of 100 
instances of the Text class currently running on the screen of the 
NeXT cube I am using to type this article. All of them are using 
the same piece of code in memory, and only the data for each 
object differs. Applications that use common object classes such 
as Text, Window and Button can use hardly any memory, 
because it is possible for them to use very little new code. 
OpenStep can be very efficient, and the only development 
system even remotely comparable is Smalltalk. In short, 
OpenStep is a developer's dream — keeping NeXT in business 
despite arguably the worst overall smart-but-dumb management 
in the computer industry. 

Finally, there are some wonderful surprises in store for 
Macintosh developers. The first is that NeXT has enhanced 
OpenStep with some pseudo-realtime capabilities for 
developers wanting to do animation. These capabilities take the 
form of the DPSTimedEntry, a request to the operating system 
to call a certain function at a certain interval. Since Openstep is 
a preemptive multitasking system, DPSTimedEntries are not 
truly realtime, but the system usually has no trouble achieving 
granularity fine enough for seamless animations. 

The second surprise is that OpenStep’s 3DKit is based on 
Renderman, the scene description language from Steve Jobs’ 
other company, Pixar. You may recall Renderman’s scene 
description language was used to create the movie Toy Story, 
and there truly is no substitute. Some of the best modeling 
software available is built on OpenStep and 3DKit, and many 
Mac developers will be ecstatic to gain access to Renderman. 
It’s built into OpenStep’s development libraries. 
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OPENSTEP’S WEAKNESSES 

One of OpenStep’s greatest weaknesses is its UNIX file 
system, and the BeOS is far better than Openstep in this area. 
From the point of view of a Mac programmer, the UNIX file 
system might seem great at first because of its reliability, 
support for essentially unlimited path- and filename-size, and 
great support for security. Unfortunately, however, the UNIX file 
system has grown pretty archaic in many ways and it is arguably 
unsuitable for a personal computer. Long ago NexT promised 
OpenStep developers that there was a completely revamped 
object-oriented file system on the way, similar to the BeOS or 
Newton OS. It never arrived. Hopefully Apple will bring it out. 

The BeOS also has it all over OpenStep when it comes to 
device management. BeOS devices are just as object-oriented as 
the rest of the system, which means that a BeOS device isn't 
actually instantiated until it’s needed. It can be linked and 
unlinked on the fly, and I have to say I was completely blown 
away once by the sight of a Be computer rebooting before its 
(still-warm) monitor could warm up. The system booted with only 
the devices it needed, saving the rest until an app used them. 

The last place BeOS is really stellar is in its multiprocessor 
support. There’s no real excuse for the lack of it in OpenStep; 
NeXT just never got around to releasing a threadsafe version of 
the AppKit (the large library of object classes). So, we have an OS 
running on a multiprocessor-capable kernel with multithreading 
applications but no multiprocessing because nobody ever got 
around to revamping the object libraries. It’s a sure bet someone 
will fix this problem quickly, in fact, NeXT had a version of 
NeXTStep running on a multiprocessor machine before they got 
out of the hardware business. Some OpenStep people get sort of 
steamed when you bring up this topic. 

The new version of OpenStep, 4.0, is also no longer 
POSIX-compliant and that broke a lot of applications. Lots of 
OpenStep people get pretty steamed about this topic as well. 

OpenStep is far less flexible than MacOS when it comes to 
game or multimedia development. Something like RAVE+Game 
Sprockets is needed badly. 

Last, but not at all least, the OpenStep Workspace Manager 
GUI needs a revamp as much as the Finder’s GUI. In some 
ways it is more friendly, but in some ways it really needs many 
of the same changes the Macintosh Finder is getting. Again, not 
a hard problem to solve. 


CONCLUSION 

That summarizes Apple’s acquisition of NeXT Software from 
the point of view of a longtime Mac fanatic and OpenStep 
developer. I still really can’t figure out what at NeXT was worth 
$400 million, but it’s a great PR move and I think it was done right. 
I'm happy to have Apple supporting my favorite OS, and I can 
now postpone my port of Objective C to the Macintosh yet another 
time. Like many OpenStep developers, I got a better Christmas 
present than I could ever have imagined, and I think everyone 
who will use a computer in the next few years did also. 


A QUICK TAKE ON APPLE'S PURCHASE Or NEXT 





RHAPSODY 





By Michael Rutman, independent consultant 








C++ Versus Objective-C 





What will programming in 
Objective-C mean to the C++ 


programmer? 





DIFFERENT OBJECT ORIENTED LANGUAGES 


Almost all of us have heard the term 
object oriented programming, and most of 
us have used C++. How will Apple’s 
purchase of NeXT, and NeXT’s framework 
using Objective-C affect us as we develop 
software? If we know C++ already, how 
hard will it be to get up to speed on 
Objective-C? Many people will agree that 
once they understand the concepts of 
object oriented programming it doesn’t 
matter which language they use. To a 
degree this is true, but development is 
easier if the programmer adopts a 
programming philosophy based on the 
peculiarities of the language. 

C++ has a very diverse syntax, many 
language extensions, and hundreds of quirks. 
In my first year of C++ programming, | 
thought that I understood all the important 
concepts. In my second year, I thought I had 
it mastered. However, after all this time, I’m 
still learning about esoteric things that can be 
done in C++, and the bizarre syntax needed 
to access those features. 

On the other hand, Objective-C is a 
blend of C and Smalltalk. Most of it is 


straight C, with embedded Smalltalk. Assuming you already 
know C and C++, then you know most of the syntax of 
Objective-C. When reading Objective-C code, an easy way to 
understand the syntax is to know that [anObject aMethod] in 
Objective-C is the same as anObject->aMethod() in C++. This is 
over-simplification, but it is a useful rule for getting started. 


How Do I DECLARE AN OBJECTIVE-C OBJECT? 

C code is the same in Objective-C and C. Unlike C++, where 
a few K&R C constructs have been changed, straight C in 
Objective-C is straight out of K&R. Many people remember how 
Casy it is to write sloppy code in K&R C. Fortunately, NeXT uses 
gcc, which has adopted ANSI C. This means that we can write 
sloppy code for NeXTSTEP, but activating the ANSI C violation 
warnings can help us clean it up. 

Classes are different between C++ and Objective C, especially 
in the declaration of the classes. In C++, each class is a structure, 
and variables and/or methods are in that structure. In Objective-C, 
variables are in one section of the class, and methods in another. In 
C++, methods look like C functions, in Objective-C, methods look 
like Smalltalk methods. Listing 1 shows two examples of class 
declarations. The first class is a C++ class, the second is the same 
class in Objective-C. NeXTSTEP allows programmers to merge C++ 
and Objective-C in the same file. 


Listing 1 
class Foo : public Bar 
{ 
public: 
Foo(int aValue); 
“FOO 1.) 4 
int CallFoo(intaValue) ; 
int Value(); 
static (foo *)MakeFoo(int aValue); 
private: 
int myVariable; 
int value; 


——__—_————- roo eee 
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@interface Foo:Bar 
{ 
int myVariable; 
int value; 


+ (Foo *)MakeFoo: (int) aValue; 
- jnitFoo: (int) aValue; 

- free; 

- (int)callFoo: (int) aValue; 

- (int)value; 


@end 


Some things to note 

The Objective-C class allows a method and a variable with the 
exact same name. In C++, they must be different. In Listing 1, the 
method and variable use different cases to differentiate them. 

Objective-C does not respect public and private as does 
C++. It knows about them, but doesn’t really use them. 

Objective-C does not have a constructor or destructor. Instead 
it has init and free methods, which must be called explicitly. There 
is nothing in the Objective-C language that requires them to be 
called init and free, it’s just a standard practice. 

Objective-C uses + and - to differentiate between factory and 
instance methods, C++ uses static to specify a factory method. 


How Dogs AN OBJECTIVE-C METHOD LOOK? 

The declaration of a method is more like Smalltalk than C, 
but once in a method, it is easy to follow. Each method call is put 
inside of square brackets ((]). Listing 2 shows a C++ and an 
Objective-C method. 


Listing 2: 


int foo::callFoo(int foo) 
{ 
int count; 
int result = 0; 
HelperObject object; 


for (count = 0; count < foo; countt+) 
result += object.Value(count) ; 
return result; 


int callFoo: (int) foo 
{ 
int count; 
int result = 0; 
HelperObject *anObject = [[HelperObject alloc] init]; 


for (count = 0; count < foo; counttt) 
result t= [anObject value:count] ; 

[anObject free]; 

return result; 


These two languages, despite doing the same thing, look 
quite a bit different. The declaration is also different. In C++, we 
use a C declaration, but add the class name with some colons. In 
Objective-C, we use a Smalltalk definition. The type is declared, 
and the function name is followed by : and parameters. Each 
parameter is separated by colons. In addition, each parameter can 
be named, though the parameter name is only used for 
overloading. So, we can have two methods in the same object: 
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- (int)foo: (int)x bar: (int)y; 
- (char *)foo:(int)x baz: (int)y; 


The two methods in these functions, even though having the 
same name, have different return types. In C++ this is not 
permitted, but in Objective-C it’s perfectly valid. In reality, their 
names are foo:bar: and foo:baz:, and there is no function 
overloading, but it is as close to function overloading as 
Objective-C gets. 

Once in a method, Objective-C is read like straight C with 
embedded Smalltalk. Note that the HelperObject has to be 
created and destroyed manually, and also note that the 
HelperObject cannot be on the stack. 

The last thing to note is the syntax of a method call. object- 
>method(parameter) becomes [object method:parameter]. 

On occasion, Objective-C code will have a method with no 
type declared for its return value, or for some of its parameters. 
In C, when there isn’t a type, then it is an int. In Objective-C, 
though, it is an id, which is a generic object type. Unlike C++, 
where there is strong typing, Objective-C allows weak typing for 
generic objects. 


Wat Dogs OBJECTIVE-C HAVE THAT C++ IS MISSING? 

Objective-C offers runtime binding. C++ tries to fake it with 
mix-in classes and virtual functions, but after using runtime 
binding, I find that C++ is a frustrating language. For example, in 
most C++ frameworks, Windows are a subclass of a View object 
because that’s the only way for both of them to have display 
methods that can be called by any object. In Objective-C, there 
can be display methods in any object, and at runtime the correct 
method will be called. This means that Window class and View 
class don’t need a common superclass to define Display. No need 
to bastardize the object chain to get around the lack of runtime 
binding. On the other hand, Objective-C can have runtime errors, 
where C++ will catch those errors at compile time. 

Another advantage of runtime binding is avoiding the 
“fragile base class” problem found in C++. This is when there is 
a change in a class in a shared library, the lookup tables will 
change, and this will break every app using the library. 
Objective-C doesn’t have this problem because each method is 
looked up at runtime. 

A third advantage of runtime binding is dynamic linking. 
Apple is constantly coming out with new shared library formats, 
such as CFM, ASLM, and SOM. Since there is runtime binding in 
Objective-C, loading a shared library is straight forward. They 
come in bundles, which are just object files, they get loaded 
with one call, and their objects are added to the runtime 
environment. Their format is defined by the language. 

Yet another advantage of Objective-C is seen in Interface 
Builder, Metrowerks Constructor is an amazing attempt to get 
an interface builder working in C++, but it pales to what NeXT 
provided 10 years ago with Interface Builder. Interface Builder 
allows the user to create User Interface, as does Constructor, 
but with a twist, Interface Builder is integrated into the 
development environment. In Constructor, each class has to 
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have a 4 letter signature that links the class in Constructor and 
the class in the code. The code also has to register the classes 
with the same 4 letter signature and a construction method that 
creates an instance of that custom class. When a class is created 
in Interface Builder it has to have only a name. Interface Builder 
will even create stubbed out files for the project. Objective-C uses 
the class names to match up classes in Interface Builder to classes 
in the code. No 4-letter codes; no registration routines. 

Two of the best features of Objective-C, proxies and categories, 
also come from the runtime binding. Occasionally, there is a root 
object that is missing some important functionality. We really want to 
add that functionality, but the only way in C++ of doing that is to 
modify the class library. Objective-C provides two means of adding 
functionality to a library without recompiling. The first is called 
proxy. As long as there aren’t any extra instance variables, any 
subclass can proxy itself as its superclass with a single call. Each 
class that inherits from the superclass, no matter where it comes 
from, will now inherit from the proxied subclass. Calling a method 
in the superclass will actually call the method in the subclass. For 
libraries where many objects inherit from a base class, proxying the 
superclass can be all that is needed. 

Categories are like proxies, but instead of replacing the 
superclass they just extend the superclass. In C++, each object 
must be explicitly declared, and each subclass must know 
everything about the superclass at compile time. In Objective-C, 
new functionality can be added to existing classes by adding a 
new category. Shared libraries that depend on a base class that 
has been extended will continue to work, and new classes 
created can call the additional methods. 


WuatT Dogs C++ HAVE THAT OBJECTIVE-C Is MISSING? 

C++ has tons of features not found in Objective-C. 
Objective-C is a simpler language. Objective-C tries to blend the 
purity of Smalltalk with the simplicity of C. However, some 
people have said that Objective-C blends the lack of readability 
of C with the limitations of Smalltalk. 

The biggest C++ feature that Objective-C does not have is 
constructors/destructors. In Objective-C, the initialization and 
free methods have to be called manually. With Foundation Kit, 
NeXTSTEP provides garbage collection, so objects don’t have to 
be explicitly freed, but the destructors won’t be called when an 
object falls out of scope. One C++ object I love is a HandleLock. 
A HandleLock is used to lock a handle, when it falls out of 
scope, the handle’s state is restored. No need to remember to 
unlock the handle. This capability isn’t available in Objective-C. 

Objective-C also does not allow stack based objects. Each 
object must be a pointer to a block of memory. Memory 
allocations on the Macintosh are expensive. Under NeXTSTEP, 
virtual memory and a decent memory manager means little 
heap fragmentation, and therefore, memory allocations are 
much cheaper, so embedded objects are not as important. 
However, putting an object on the stack or inside another class 
without additional memory allocations is a nice feature that I 
miss when I program in Objective-C. 
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Another missing feature is overloading. Objective-C has a 
work-around for method overloading, but none for operator 
overloading. Personally, I don’t like operator overloading, so I 
don’t really miss it. Listing 3 shows a C++ and Objective-C objects 
using method overloading. 


Listing 3: 


class foo 

( 

Dit Lies 
int foo(char *fooValue, int number); 
int foo(char *fooValue, char *string); 


i: 


@interface Foo 
{ 
} 


- (int) fooByInt :(char *)fooValue 
- (int) fooByString: (char *)fooValue 


byInt: (int) number; 
byString:string; 


@end 


In Objective-C the message overloading is faked by naming 
the parameters. C++ actually does the same thing but the 
compiler does the name mangling for us. In Objective-C, we 
have to mangle the names manually. 

One of C++’s advantages and disadvantages is automatic 
type coercion. At times, it is nice to be able to pass an object of 
one type and have it automatically converted to the correct 
type. Unfortunately, often enough, it is doing the wrong kind of 
coercion, and a nasty bug appears. In Objective-C, to coerce a 
type, it must be explicitly cast. 

Another feature C++ has that is missing in Objective-C is 
references. Because pointers can be used wherever a reference 
is used, there isn’t much need for references in general. Some 
programmers like them for stylistic reasons though, and they 
will likely miss them. 

Templates are another feature that C++ has that Objective- 
C doesn’t. Templates are needed because C++ has strong typing 
and static binding that prevent generic classes, such as List and 
Array. With templates, a List of Int class easily can be created. 
Under Objective-C, List classes hold objects, and the List class 
does not care what kind of object it is holding. C++ will 
guarantee that each object put in the List of Int is an int, at least 
theoretically guarantee it, while Objective-C makes no such 
guarantee. Objective-C’s runtime binding makes List easier to 
use, but the safety of compile-time binding is lost. 

Both Objective-C and C++ offer abstract objects, but 
Objective-C allows it only by generating runtime errors when 
instantiated. C++ compilers will not allow an instantiation of an 
abstract object. This is another example of C++ doing static 
binding and Objective-C doing runtime binding. 


PHILOSOPHY OF EACH LANGUAGE 
Think of Objective-C objects like a factory, and C++ objects 
like a home business. Objective-C objects tend to be large, self 
contained, and do everything imaginable. C++ objects tend to 
be small and to the point. C++ objects also tend to come in 
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groups, where Objective-C objects tend to be more standalone. 
This does not mean that there can’t be small Objective-C objects 
and large C++ objects, it only means that the trend is for 
Objective-C objects to be large, standalone objects and C++ 
objects to be small and dependent on one another. 

When programming in C++, each and every concept, no 
matter how small, should get its own class. Applications 
typically have hundreds, if not thousands of classes, each one 
small, and all interconnected. This can lead to name collisions, 
but C++ has solved some of these problems by using 
NameSpaces. Even without NameSpaces, C++ can avoid name 
collisions by including only needed header files. Two classes 
can have the same name if they are private and never included 
_by the same file. 

Objective-C objects should be able to stand on their own. 
There are no private objects, only one name space, and object 
names are resolved at runtime. Having thousands of Objective- 
C objects is asking for trouble. 

C++, with its zero overhead for non-virtual classes, encourages 
programmers to subclass ints, rects, and any other data structure. 
Writing a little bit of code can give range checking, type checking, 
value checking, or any other kind of checking imaginable. 
Objective-C has a lot of overhead for an object, and there is no 
operator overloading. It is not practical to have Objective-C classes 
for rects, ints, or other small data structures. 

Despite many applications having been written in C++, and 
C++ having many features over Objective-C, I find writing 
applications in Objective-C much easier and faster than writing 
the same applications in C++. One of the biggest reasons for this 
is the number of objects found in an application. In Objective-C, 
having less than 100 objects in an application lets me keep the 
entire structure of the program in my head. In C++, where each 
concept is its own object, I am constantly looking for which object 
contains the functionality I’m looking for. 

Another reason why Objective-C is faster to develop in is 
that it is a simpler language. I have seen programmers spend 
days trying to get the syntax of an esoteric C++ function just right. 
Objective-C does not have as many areas where language 
lawyers thrive. The worst part of C++’s esoteric syntax is other 
programmers might not be able to understand some of the more 
complex C++ code. 

The biggest reason for the faster developement time is 
the self-contained object. Objective-C objects tend to be self- 
contained, so if you need functionality, you only need to 
include that one object, or occasionally a small number of 
related objects. C++ objects, on the other hand, tend to come 
in groups. Each time you want to include functionality from 
an object, you are likely required to include an additional 10- 


20 objects. 


WHICH LANGUAGE SHOULD I USE IF 
I AM PROGRAMMING NEXTSTEP? 
The wonderful part about NeXTSTEP is that it supports 
both C++ and Objective-C. However, it’s framework is in 
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Objective-C, and calls to the framework are best left in 
Objective-C. While working with the framework, you are best 
off programming in Objective-C. 

However, if you want a lightweight object with 
constructors and destructors, you can throw in a C++ object 
anywhere you want. With C++ objects, you can have the best 
of both worlds. Listing 4 shows an example of using both 
languages at the same time. 


Listing 4: 


class ListLocker 
{ 
private: 
Leer alia: 
public: 
ListLocker(List *aList) (theList = aList; [theList lock];} 


~ListLocker () {{theList unlock] ;} 


ie 
- (void) objectiveCMethod: (List *)myList 


ListLocker lock(myList) ; 
[myList doSomething] ; 


In Listing 4 we create a lightweight C++ object that will 
lock and unlock an Objective-C class as needed. In our 
Objective-C method, we put the C++ object on the stack, 
which locks the list, and when it falls out of scope the 
destructor will unlock the stack. 

So, my advice is to use both as you need them. Use the 
flexibility of Objective-C for most of your work, and use the 
lightweight C++ objects as tools to help you. 

If you want to get started exploring Objective-C, check out 
Tenon’s CodeBuilder at <http://www.tenon.com/products/codebuilder/>. 
More information about Objective-C can be found on NeXT’s site 
at <http://www.next.com/NeXTanswers/htmifiles/ 1 38htmld/138.html/>. 


Want to know what 
products are available 
for MacOS development? 


Check out 


Developer Depot™ 
<http://www.devdepot.com> 
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Jon Watte, Metrowerks BeMeister 


This month’s Factory Floor interview is 
with Jon Watte, leader of Metrowerks BeOS 
tools effort. With all the interest in the 
BeOS brought on by prospective deals with 
Apple (as of this writing, not yet decided) 
and a bundling deal with Power 
Computing, I asked Jon if he wouldn’t 
mind answering some questions about his 
involvement with Be. 


Dave: How did you hook up with 
Metrowerks? 


Jon: All the applications I wrote and 
designed at SCOOP were coded using 
the Think Class Library, using Think C 
versions 6 and 7. When the time came 
for Apple to roll out the PowerMacs, 
Symantec did not have a solution for us, 
so I went ahead and ported the TCL 
from Think C+- to “real” C++. I also 
wrote some utilities that would do the 
hard work of converting a TCL 
application to use this TCL version for 
PowerMac. I released this port publicly 
in several versions and, through it, got 
the attention of people at Metrowerks. 


Meanwhile, my wife and I entered into 
something called the Diversity of 
Immigration Visa Lottery, or “green 
card lottery” for short, where US 
immigrations randomly selects among 
qualified applicants from nations with 
under-representation in US immigration 
statistics. Most people don’t “win” this 
lottery, but my wife did. The only crux 
was that you had to secure an offer of 
employment from the US to be able to 
enter. I guess they were afraid people 
would move from the Swedish welfare 
system to live on American welfare. I e- 


JON WATTE, METROWERKS BEMEISTER 








mailed everybody I knew in the US from the ‘net and visits to 
trade shows, and literally thirty minutes later I had a reply 
from Greg Galanos, saying he had just thought about me for 
this secret new project they were starting... the Be port of 
CodeWarrior. 


Dave: What were the early days in the Be universe like? 


Jon: I actually had one of the first BeBoxes at home in 


Stockholm, a machine based on the AT&T Hobbit. The 
hardware wasn't very fast, but the machine was nice anyway. 
Once I managed to clear through the US visa process (which 
took much longer than I would have liked), I moved to the 
US at the same time as the PowerPC-based BeBox prototype 
appeared. 


At first, the machines were very bare-bones; I had the deluxe 
model with a sheet metal frame (no cover) whereas people at 
Be usually kept their machines as circuit boards laying on their 
desks (they still do.) Back then, there wasn’t even any 
debugging except for printf(). You compiled your program on a 
Mac using CodeWarrior, FTP’ed it to the BeBox, ran it there 
and watched it spit out text in a terminal window. 


There was only a small circle of developers then, many of 
them from France where Be got much of their initial capital. 
There were also no mailing lists or news groups in which to 
discuss the system — they were keeping a very low profile in 
order not to hype the machine before it was ready to be 
shown. We all worked under NDA and had to cover the 
machine with blankets when relatives were visiting. Every 
two to three months, we would go to Be to talk about what 
we were doing and in which direction to move, as well as 
bug them until they fixed the bugs we were running into. 


Dave: How did CodeWarrior for BeOS evolve? 


Jon: My initial task once I moved to the US was to design and 


write an IDE, while the other team member (another John) 
ported the compiler and linker. One interesting quirk soon 
developed; Be was doing all the compilation under SCO unix 
and Linux, because those boxes could run NFS which was 
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needed for their source-code control system. In fact, I think they 


still do. That meant that we had to port our compiler to run Finish you i installer 


under UNIX on a little-endian machine, a job which later turned 


out to benefit us when we ported to Windows. — | 
in record time 
Anyway, while we were cross-developing from the Mac, we ss 
with Draginstall. 





soon felt the need for a cross-debugger as well. The only 
problem was that the BeOS did not support debugging — 
and since it has protected memory, you can’t just write 
breakpoints into code as you can on the Mac. I put the IDE 





work on the back-burner and helped Be co-design the system You've run a long race. 
API for debugging, based on the requirements the 
Metrowerks debugger had at that time. Once that was done, I You're almost done with your product. 
could write a debugger Nub that ran on Be and adapt the 
Metrowerks debugger to talk to this Nub instead of a local Now that it’s time to build your installer, 
Mac Nub. This was still back when the machine was secret, don’t let complex licensing arrangements 


and we wrote the debugger mostly for our own use and that 
of the few select developers in on the secret. and complicated tools trip you up. 
When I was almost finished with this, the other team member 
left Metrowerks, and I was left alone in charge of the Be team. 
Quickly finding another programmer to help out (Brian Stern) 
as well as leveraging the skills of the MPW/command-line 
tools guy (Mark Anderson) I put together a new Be team 
within Metrowerks, and showed Brian the design I had for 
the IDE. Mark already did MPW compilers and linkers, and 
quickly caught on to Be, which left me with the task of 
writing the “real” Be debugger. 





Dave: Is that where the Be version of PowerPlant came Download a demo of Draginstall 
to be? from http: //www.sauers.com/draginstall 


Jon: Yes. We looked at the cross-debugger, and wondered Build your installer 
how to move the technology over to BeOS. It turned out in a single step with DragInstall’s QuickScript feature 
that the debugger source code had some ugly interrelations ° 
between UI Be functionality that made perfect sense on the Register Draginstall 
Mac but wouldn’t work in the multi-threaded Be world. So with single phone call to 1-800-890-9880 
we had the choice of developing a new debugger from And cross the finish line 
scratch, or somehow porting the MacOS debugger. After 
some going back and forth, we settled on making the total time: 1 hour, total cost: $300 
debugger believe it was running on a weird kind of Mac. 
Since the debugger code was non-reentrant, we had to re- r= 
implement the entire event loop layer; the current Be fie. GS) 
debugger still sits in WaitNextEvent() waiting for things to be 5 @, <A FO 
thrown at it. Since all of the former Mac code runs in the 5 * 4 . 
same thread because of that, the reentrancy problems went 7 = 
away, at the cost of implementing about 300 toolbox calls 
and some PowerPlant classes. 

Dave: What is the state of Be development today? 





Jon: The larger companies that have lots of code vested in 


other OSes are being silent. I’m sure they’re working with For more information: 
BeOS internally, but need inone Wane tO See if ill be a sic ia Ray Sauers Associates, 1187 Main Avenue, Suite 1B, Clifton, NJ 07011 USA 
platform. Meanwhile, smaller, nimbler developers who don't voice: 201.478.1970, fax: 201.478.1513, email: info@sauers.com 


mind throwing away lots of code and starting over are 
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waking up and smelling the coffee — a brand new frontier 
waiting for fortunes to be made off of it. 


If you’re thinking of moving a Mac program to the BeOS, you 
have to realize that, PowerPlant portability or not, it may be 
hard, or not even make sense. The BeOS is different; it has a 
different UI and a very multi-threaded concept. Users are 
quickly getting used to being able to perform all kinds of 
actions simultaneously, and modal dialogs are few and far 
between. Mostly because they’re so hard to implement, | 
think, and I love it that way. It’s easier to create a modeless 
dialog than a modal! 


If we make the PowerPlant layer available, it'll probably be 
useful if you have a PowerPlant application on the Mac, but 
it'll also still require work in the app. It’s not a miracle pill. 
The current version “solves” the re-entrancy problem by 
having all the windows and menus send messages to the one 
“Mac Toolbox” thread, which means that the program will 
never truly feel and behave like a real Be program. 


The right thing to do is to re-map the interface classes you 
may be using currently onto Be classes, and make sure that 
the underlying “engine” code is thread-safe and re-entrant. 
Maybe you can even take advantage of some BeOS features 
on your code, such as easy add-ins, pre-emptive multitasking 
or memory mapping of data files. That will make an 
application sing, and is of course the direction we want to 
take our internal code in. Whether this will be done in the 
PowerPlant context, or by separating engine from UI remains 
to be seen. 


Dave: How stable is the Be platform for development? 


Jon: Well, I don’t have to reboot the machine every time I 


crash. It’s sometimes also nice to have a command-line in the 
system - even though I’m a die-hard CodeWarrior IDE user, I 
had to go to MPW now and then on the Mac. On Be, it’s GNU 
“bash” that’s the shell, and there’s a gazillion little utilities 
already written for it that you can use. 


CodeWarrior runs well under the BeOS, although we spend 
much time waiting for the file system. The new file system 
promised in DR9 looks as if it'll fix that problem. Being able 
to type and edit unhindered while running a compile - or two! 
- at the same time is something I miss everytime I go back to 
the Mac. 


However, every four or five months, Be comes out with a new 
version of the OS, and lots of things changed that you have to 
catch up with. Old programs don’t usually work on the new 
version of the OS, since they have the luxury of changing the 
APIs. That will stop once they reach larger, non-developer 
markets; currently release DR9 (the next after the MacTech 
release) is supposed to be “Compatibility Lock”. 
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It’s extra hard for us, because our tools ship with the OS and 
have to be developed, debugged, and tested by the time the 
OS ships - but Be typically fixes bugs that breaks 
compatibility while we do that, and once the “last bug” is 
fixed, they document it, test it, and ship, so we have to get 
in early, roll with the flow, and hope the APIs work as we 
think they do... 


Dave: How do you feel about Be’s choice of C++ as the 


Be API standard? 


Jon: —_[ don’t mind C++. It’s certainly a language with wide 


industry adoption and also well understood system 
characteristics. Many of the nicer, more dynamic languages 
would need special hardware (mark and type bits in 
memory) to run really well, which would drive prices up. 
Meanwhile, there’s a lot of C and C++ source available for 
porting; most public source is C or C++, so it’s an obvious 
language to support. 


Pascal affecionados will of course be somewhat unhappy, 
but in the grim world of business, I think the sentiment is 
that they’re not a big enough force to cater to initially, 
although I hope Pascal and other languages will arrive at 
some point. We’ve done some looking into this at 
Metrowerks, and there is no reason why you can’t make 
Object Pascal code generate C++ compatible objects; it’s just 
a SMOP. (“Small Matter Of Programming” — a term that 
means lots of sweaty work.) 


The fragile base class problem has several different solutions, 
and I think it will not be a big impediment to the BeOS. 
We've talked to them, and they’re on the ball with a solution. 


Dave: Many prospective developers ask about the types of 


software they should develop for the BeBox. Any advice? 


Jon: — There are lots of things I want to see. Sticking to the 


“content development” niche that Be says they want to 
target, I could see how you could write an integrated radio 
station program that kept all of the play lists, spot lists, 
helped out with traffic planning, and generated all the 
reports you’d want. Storing the actual songs and “canned” 
shows and interviews in MPEG and playing them back in 
real time from disk or network would also come in handy. 
The BeOS is really tuned for this combination of “soft real- 
time” and GUI tasks. Connecting back to my previous 
work in publishing, given some people and some dollars, 
the right person could create a kick-ass integrated 
newspaper publishing solution; the only problem being 
that Quark XPress is a formidable competitor in page 
layout. But that is only part of the publishing chain; the 
BeBox has everything else it takes to implement that kind 
of solution already. 
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Increase Your Software sales 


WIBU-KEY “ Copy Protection provides the most _& 
secure and flexible software protection available. 


WIBU-KEY has been protecting software around the world 
since 1989. WIBU-KEY combines the most sophisticated 
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Secure Remote Programming customer 


Tel: 913-832-2070 * Fax: 913-832-8787 


i\\\n, 1617 St. Andrews Drive ¢ Lawrence, KS 66047 
4 
A Email: sales@griftech.com 


™ 


Consistent API for Mac and 
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WWW.griftech.com 
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Belgium, Lux. Compusec Tel: +32-2-6450944 Fax: +32-2-6464266 Croatia Aries D.o.0. Tel: +385-1-222752 Fax: +385-1-2326535 Estonia Lansoft Ltd. Tel: +372-2-444760 
Fax: +372-2-682760 Japan Visual Networks Co. Ltd. Tel: +81-3-340-57801 Fax: +81-3-340-57818 Netherlands Compusec Tel: +31-53-5740223 Fax: +31-53-5726822 


Dave: Can you tell me about Datatypes.lib? (a data 
translation library Jon wrote in his “copious” spare 
time and which is starting to see major adoption 
among Be developers.) 


Jon: The cool thing about BeOS is that everything is new. 
The bad thing is that it’s pretty sparse on the nicer amenities. 
However, the design of the BeOS makes it so that Be doesn’t 
have to provide every system service an application might 
want to rely on. 


A case in point is Datatypes.lib, a generic data translation 
service much like EasyOpen on the Mac, except with an API 
mere mortals can understand. It started as a request to Be 
from some old Amiga developers to adopt the Amiga 
“datatypes” system service, which apparently is a very basic 
way of identifying and loading the contents of a disk file into 
an application. Many people liked the idea, but thought the 
Amiga implementation was flawed, and a lot of discussion 
ensued. To cut down on the clutter and flames, I decided 
one weekend to take the best of the discussion and just 
implement it. I did, and posted the result for comments. The 
first round was pretty harsh (and rightly so) but version 1.1 
really had everything you’d need in a basic data translation 
package, including identification, import, export, making it 
easy to write add-on translators, and abstracting translation 
from storage so you could use any translator going to/from 
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any source (such as disk, memory, or a network 
connection). Judicious use of C++ abstract base classes 
made this both forward compatible and easy to implement. 


The library wasn’t all that hard to write, thanks to the Be 
kernel threading and code add-on model, and people are 
already both using it in applications and writing translator 
plug-ins for it. This means that your, say, sound editor 
program doesn’t have to know about every imaginable 
sound file format, just the “standard” format and rely on 
Datatypes.lib to provide translation. 


Jon Watte, born in Stockholm, Sweden, currently lives in 
Austin, TX, where he is head of BeOS tools at Metrowerks. 
Before joining the Be team when it was formed, he was head of 
development for three years at SCOOP, a Swedish pre-press 
software house. He has also worked as a consultant in 
frameworks, networking and databases. 

Prior to leaving the Mac community, Jon was often seen 
helping budding Mac programmers out in the news group 
comp.sys.mac.programmer. He has presented at the MacHack 
conference and was voted “Official SmartFriend” - most 
helpful Mac netizen - in the 1995 Usenet Mac Programmer's 
Awards. You may have seen clones of him who spell their 
name slightly differently: Watte or Watte, for example. It’s all 
part of an obscure Swedish conspiracy to rule the world. Wau 
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SYMANTEC 
TOP TEN 





VANNTEDON | 


By Richard Hill, Symantec Technical Support 





This monthly column, common (but just as obtrusive) condition has to do with the 


Project Type setting in the Project | Options submenu. If either 
Shared or Static Library is selected for the project type, the 
debugger will be disabled for this project. If the type has been 
erroneously set to a library, set it back to Application and then 
Remove Objects from the Build menu. All should be well. 


written by Symantec’s 
Technical Support 
Engineers, aims to provide 


you w ith technical Q: My loop control condition in C is not evaluating correctly. I 


information based on the 


use of Symantec products. 


Q: My Visual Architect project uses a 


modal dialog that I want to be able to 
make appear and disappear without 
repeatedly allocating and releasing 
resources. How would I do this? 


: While not immediately obvious, the 


answer to this is fairly simple. Since 
CDialog and CDLOGDialog are 
descendants of CWindow, you can use 
CWindow’s member functions Hide() 
and Show() to control visibility. To 
make the dialog ‘go away’ without 
releasing its resources use myDialog- 
>Hide(). Whether it is visible or not, 
you can update its contents to your 
liking. Re-display it at the appropriate 
time with myDialog->Show(). 


: My Symantec C++ Project will not run 


under the debugger. What might be 
the problem? 


: There are a couple different reasons for 


this problem. The most common culprit 
is corruption in one of your built 
objects. Choosing Remove Objects from 
the Build menu is the easiest way to 
deal with this offender. Another less 
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know x has reached 10, but control is staying in the loop. 
What's going on? 


while (x>10) 
| 
eee as 


: The problem here has to do with rounding and floating point 


precision. Try this instead: 
while (abs(x-10) > 0.0000001) 


Obviously, you can change the precision level by changing 
how many decimal places to use. 


: My Java applet is accessing an SQL database through 


dbANYWHERE. The data in my result set is acting weird. 
Among other things, my comparisons are not evaluating they 
way I know they should. 


: As it turns out, some SQL databases return their data padded 


to the length of the field (as defined in the database) plus 1 
character (the delimiter). Luckily, Sun included a trim() 
method in the java.lang String class. If the database you are 
connecting to returns padded strings, get in the habit of 
calling myString = myString.trim(). 


: | want to use a String as my conditional but (myString == the 


text) is not evaluating true when I know it should. 


: The problem here is that Java defines a String as an object, 


not a primary data type. You can still do what you want, you 
just have to use the String member function .equals(). Try this 
instead: if (myString.equals(‘the text”) {}. This will evaluate to 
true when it should. 


MACTECHMAGAZINE @ MARCH 1997 








World 
Wide 
Web 
Weaver 


For 
Macintosh 


and 
PowerMac 








¢ Tables (creating, editing, and importing) 
e Limited site management 

e Forms 

e Page colors 

e Frames 

e Text and styled text importing 

e Add your own tags 

e Very customizable 

e Preview with different web browsers 

¢ Includes two free upgrades 


World Wide Web Weaver, the professional World Wide Web 
page creation tool, is an application designed to help you 
create World Wide Web pages using an easy yet flexible 
interface. World Wide Web Weaver gives a true WYSIWYG 
preview of your document, which is updated as you type, 
allows you access to all HTML, yet does not expect you 
type any HTML yourself (unless you want to!) 


“Miracle Software’s World Wide Web 
Weaver 1.1 is a simple, usefull HTML editor 
that helps authors think visually while 





editing HTML tags.” 
MacUser, August 1996 
$89 - Direct From Miracle Software (315) 265-0930 
$79 - From Mac Zone (800) 248-0800 


$60 - Educational price (direct only) 
$35 - Upgrade from World Wide Web Weaver 1.x (direct only) 
Call for Multi-User Packs 


For the latest ordering information point your web browser to 
http:/ /www.MiracleInc.com or call (315) 265-0930. 





$95,00 


60-day MBG 


Automated testing 


5 just got easier: 
| | 2 query & control the interface 





Runtime: $25 ea. 


PREF AS 

PLAYER 1 1 (version 1.0 shipped Aug. 1964} 

Like a player piano, Player mimics user input. 
Your scripts can choose from menus & pop-ups, select radio 
buttons, type text, determine the name of the frontmost window, 
the state of a checkbox, etc. For AppleScript and Frontier. ® 


Complete details and free 30-day trial version on our website. ® 





A a a ® 
Brian M. Criscuolo, DataViz 


The simple way $95.00 
to handle 60-day MBG 
complex text™ 


see website 
for discounts on 
pre-release 
versions 





TEXT MACHINE (version 1.0 to ship Q2 1997) 


Search and replace patterns of text using simple 
keywords instead of cryptic grep syntax. 

Cleanup and convert text for web publishing, 
e-mail management, DTP, database import, etc. 





Version 1.0 will support AppleScript & Frontier, 
Version 1.1 will add a dialog for OpenDoc. 


® 420A Main Street 
—_ Acton, MA 01720 
* Net Tip 508-266-2885 


player@prefab.com 





www.prefab.com 





Q: I really love Symantec C++ and think it is the best 
development environment around, but I have to do some 
development using libraries that only exist for Metrowerks 
CodeWarrior . What can I do? 


A: Rest at ease. We have developed a translator that allows you to 
use the MW libraries transparently with your Symantec C++ 
projects. The translator should be available at our WWW site 
(ftp.symantec.com) by the time this goes to print. 


Q: I have been using Symantec Café (developer release) for 
some time now. I just upgraded my Mac and now Café will 
not compile anything. What is going on? 


A: If you just copied the Symantec Café folder from one drive to 
another, rather than reinstalling on the new drive, you may be 
having a problem with an alias. In the (Translators) folder 
there is an alias called Java. This alias needs to be pointing to 
the Java file in your Java Libraries) folder. If it is not, your 
project will refuse to compile. 


: I want to be able to display my source code in an html file, 


but when I try I lose my formatting, and it makes the code 
very difficult to read. 


68 SYMANTEC TOP TEN 


© 


A: Try copy and pasting your nicely formatted text from your 
editor window into a Visual Page window. Now select your 
code in the Visual Page window and select Preformatted from 
the Format menu. This method will retain all of your formatting 
and is the method we use here at Symantec. Another way to 
accomplish something similar is to drag a source code file to a 
Visual Page window. However, you may lose some formatting 
information like fonts and color using this method. It depends 
on whether your editor saves the formatting information in the 
file or determines it ‘on the fly’. 


Q: How can I change the transparency setting of an image in 
Visual Page? 


A: There are two ways to get to the right place for this. One is to 
Open the graphic image from the File menu. The quicker 
method is to hold down the Option key while double clicking 
on the displayed image. Either way will take you to an editing 
view for the image. Here you can choose what color (if any) 
to make transparent. You can define your imagemap regions 
and links here as well. 


Q: I can not get my Java application to access a files that I know 
are on my drive. What is wrong? 


A: Many Macintosh users are in the habit of naming their folders 
with a suffix of ‘f’ (Option-f). Unfortunately, the character set 
that Java supports for its paths does not include this character 
(among others). If you are having problems with folder or file 
access, check to see if any of the folders have any unusual 
characters and remove them. 


Special Thanks to Mark Baldwin, Bob Meyer, Steve Howard, 
Kevin Kenan, and Steve Wolf. Wal 


Interested in advertising 
in MacTech Magazine? 
Contact our ad sales 


department at 


<mailto:adsales@mactech.com> 
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Announcing 


MICRGGUARD+" 


Why so many developers are switching to 
MicroGuard copy protection 


™ 





@ MicroGuard is committed to uncompromising = @ MicroGuard has now surpassed its own 


technological superiority technological lead, actually improving on the best 
"Technology at its peak" is our commitment to you. That is why we have MicroGuard Plus is everything MicroGuard is, plus 40-bit encryption, two 
brought you MicroGuard Plus™. And, MicroGuard Plus is 100% additional passwords, 64-Bit Array, 32-byte public area, 45% size reduction, 
backwards compatible with MicroGuard. This means MicroGuard enhanced counter and more. In addition, MicroGuard Plus offers two new 

and MicroGuard Plus can be used interchangeably. utilities: QuickGuard™ and EasyGuard™ allow you to protect your 


applications without touching your 
source code. The only feature that 
is not plus is the price. :-) 


Just as we promised! 


@ MicroGuard offers you the 
most sophisticated network 
protection 


Our network protection, MicroGuard Net™, 
is so superior, we had to hire an Apple network 
engineer to execute our specifications. 


MicroGuard is the best 
selling Macintosh key in 
the world 


MicroGuard sells more Macintosh 
copy-protection keys than anyone else 








in the world! 

@ MicroGuard is the only key 
developed by Mac @ MicroGuard delivers 
developers, and is the first : developer support 
and only 100% ADB savvy key within 24 hours 
We have been developing Mac applications as a seed development house We will answer any inquiry you have within 24-hours. We also have a fully loaded 
since 1984. We are not a PC protection company that has come to you AppleLink bulletin board which contains all our libraries, tech notes, Q&A and 
with a Mac product. MicroGuard is fully ADB savvy and offers extended nearly everything you'll ever need! 


addressing. Unlike other protection devices, MicroGuard never clashes 
with other keys. Only MicroGuard offers this level of sophistication. 







(actual size) 


For more information and to order a Developer's Kit or to receive a free CD ROM about M icroGuard, 
please contact us at: 









MicroGuard USA: Tel: (303) 320-1628 © Fax: (303) 320-1599 = * AppleLink: M\GUARD va 
International: Tel: (972) 3 558-2345 © Fax: (972) 3 558-2344 ° AppleLink: MICROGUARD Mac OS 
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BE DEMONSTRATES VIRTUALMAC For 
THE BE OPERATING SYSTEM 


New technology from Fredlabs, Inc. will provide a bridge for 
customers and developers making the transition to the BeOS. 

At Macworld Expo, Be Inc. demonstrated technology that 
allows the Be Operating System (BeOS) to run System 7.x MacOS 
applications directly within its multitasking, multiprocessor 
environment. 

Developed by Fredlabs, Inc., a software company based in 
San Francisco, VirtualMac allows both modern BeOS applications 
and current System 7.x applications to be active at the same time, 
and for data to be exchanged between the systems. 

Last August, Be announced it would enhance the BeOS to 
provide support for a wide variety of PowerPC based systems, 
including those based on Apple’s PowerMacintosh designs. The 
company began shipping the BeOS for PowerMac development kit 
to software developers last month. Be has committed to delivering 
“dual-boot” capability — the ability to run both the BeOS and 
MacOS (or any other system) on a single machine — when it 
delivers the first public release of the BeOS in the first calendar 
quarter of 1997. The company has also committed to delivering the 
ability to access Mac formatted disks within the BeOS, as well as 
data file compatibility and Internet compatibility between the two 
systems. 

However, VirtualMac capabilities go a step further — 
adding the ability to run System 7.x applications directly within 
the BeOS environment. During the Expo, Be and Fredlabs 
demonstrated Microsoft Word and Excel, ClarisWorks, and 
other applications running within the VirtualMac environment. 

To provide the System 7.x capabilities, VirtualMac creates a 
set of processes within the BeOS which, to MacOS applications, 
look like a Macintosh environment. In this way, VirtualMac is 
simply another task within the BeOS system. The 
implementation makes use of the MacOS ROMs found in 
PowerMacintosh hardware designs, within PowerMac clones, 
and within future systems based on the PowerPC Platform 
(PPCP or CHRP) design. 

The companies stated that it will take further study to 
determine how far the multitasking and multiprocessor capabilities 
inherent in the BeOS can be used within the VirtualMac 
environment, and the limits on compatibility with certain classes of 
System 7.x software. However, early results are encouraging, and 
one benefit is immediately apparent: If the VirtualMac environment 
encounters problems, it can be shut down and rebuilt without 
rebooting the BeOS system or the hardware. 


NEWSBITS 


OBJECTIVE-C AND ADA95 Now AVAILABLE FOR POWER MAC 
MachTen CodeBuilder — An affordable software 
development tool for the next generation MacOS 


Tenon Intersystems has extended MachTen, its highly- 
regarded UNIX system for Apple computers, to include the 
Objective-C and the GNAT-Ada 95 tool suite. MachTen 
CodeBuilder, a new offering from Tenon, includes C, C++, 
Objective-C, Java, Ada95 and Fortran77. CodeBuilder can be 
used in combination with standard Macintosh editors and 
compilers to develop Macintosh applications, X applications, and 
UNIX applications. 

MachTen CodeBuilder extends MacOS with a family of 
dynamically-linked, shared libraries that, like a Java virtual 
machine, create a UNIX virtual machine-based execution 
environment with pre-emptive multi-tasking. Tenon’s MachTen 
UNIX is based on the same Carnegie Mellon Mach and BSD unix 
foundation as Steve Jobs’ NeXT OS, making CodeBuilder a 
good platform for porting and building next-generation MacOS 
applications. 

The native PowerPC (PPC) package contains a complete 
UNIX software development environment with a source-level 
debugger and C, C++, Objective-C, Ada95 and Fortran77 
compilers all generating native PPC code. Since CodeBuilder 
creates binary PowerPC Executable Format (PEF) files that can 
integrate directly with other Macintosh development tools, 
software developers can combine Macintosh debuggers and 
compilers with the CodeBuilder tool suite to get the best of both 
the Macintosh and unix worlds. 

CodeBuilder is a powerful tool for porting existing uNIx 
applications or developing new, advanced applications on 
Power Macs and Power Mac clones. This unique toolset gives 
developers the ability to create an application with a single 
source base not only for Power Macs under a native Apple 
Operating system, but also for Silicon Graphics, SUN, NeXT, or 
HP environments. CodeBuilder gives Apple developers the 
freedom to take advantage of time-tested unix development 
tools without giving up the features of their favorite Macintosh 
editors or compilers. 

Objective-C, an object-oriented extension to the C 
language, is the NeXTStep development language. The GNUStep 
OpenStep base class library is included on the CodeBuilder CD 
as a source code compilation example. GNUStep is a widely- 
available implementation of OpenStep, the NeXT distributed 
application run time environment. The fact that CodeBuilder’s 
Objective-C is able to build and execute large sections of the 
GNUStep library demonstrates the strength of CodeBuilder’s 
Objective-C implementation. 
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StoneTable Break on through the limitations of the List Manager 


Row and column titles 
variable size row and columns 
move, copy, sort, hide, resize rows and columns 

set font, size, fore/back color, face, alignment per cell 
cell margins, top/bottom & left/right 

P.O Box 12665 drag cells in and between tables 


edit cells in place 
Portland, OR 97212 popup menus & check boxes 


68 & PPC libraries for Think C, CodeWarrior C & Pascal, MPW C & Pascal $200.00 araW BOXes around mullipie Gels 
variable size grid lines 

PICT's and controls in cells 

“LDEF-like” custom drawing function 
greater than 32K data per table 

plus all List Manager functions and more 







3224 NE 58th Avenue 


Includes PowerPlant Class for CodeWarrior 
International shipping (US Airmail) $10 
No royalty fees for applications 
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Demo - ftp://ftp.teleport.com/pub/vendors/stack/StoneTableDemo.hqx New Ve rsion 
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The fastest, cost effective way to get product off your shelves. 
For information: © Voice: 805/494-9797 © Fax: 805/494-9798 © E-mail: marketing@devdepot.com 
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METROWERKS & APPLE COMPUTER SIGN DEVELOPMENT 
AGREEMENT FOR PORTING CODEWARRIOR TOOLS TO RHAPSODY, 
APPLE’S NEXT GENERATION OS 


Metrowerks Inc. and Apple Computer, Inc. entered into a 
development agreement to accelerate support for Apple’s next 
generation operating system (“Rhapsody”) in Metrowerks 
CodeWarrior integrated programming environment (“IDE”), 
development tools and compilers. Upon completion, 
Metrowerks will provide MacOS developers a full CodeWarrior 
solution comprising compilers, programming tools and 
debuggers for the development of applications for both MacOS 
and Rhapsody. 

CodeWarrior compilers will build Rhapsody applications in 
the current CodeWarrior IDE hosted on MacOS. Metrowerks 
expects to have CodeWarrior Objective C compilers and 
Objective C runtime support in its CodeWarrior C++ compilers 
running in the CodeWarrior IDE hosted on MacOS System by 
May 1997 for the Apple Worldwide Developers Conference. 
Metrowerks will include these new CodeWarrior programming 
tools and compilers supporting Rhapsody as part of its regular 
CodeWarrior for MacOS subscription at no additional charge to 
CodeWarrior for MacOS subscribers. 

The CodeWarrior IDE, programming tools and compilers 
will be ported to Rhapsody. Metrowerks’ CodeWarrior IDE will 
be hosted on both the MacOS, as currently available, and on 
Rhapsody. The first developer release of the CodeWarrior IDE 
hosted on Rhapsody is scheduled for release in January 1998 at 
MacWorld San Francisco. Upon completion of porting the 
CodeWarrior IDE to Rhapsody, both the CodeWarrior IDE hosted 
on MacOS and the CodeWarrior IDE hosted on Rhapsody will 
build MacOS applications running on 68K and PowerPC, Apple’s 
New OS applications running on PowerPC, and Windows95/NT 
applications running on x86. 

Metrowerks intends to add cross-platform support so that 
the CodeWarrior IDE hosted on the MacOS will allow 
developers to build Rhapsody applications, while the 
CodeWarrior IDE hosted on Rhapsody will allow developers 
to build MacOS applications. 

Metrowerks PowerPlant application framework will be 
transitioned to Rhapsody. Metrowerks and Apple Computer intend 
to outline and implement a transition strategy that will allow 
developers using Metrowerks’ PowerPlant application framework 
to move their applications to Rhapsody as rapidly as possible. 


AKIMBO SYSTEMS SHIPS GLOBETROTTER UPDATE 

Akimbo Systems announced that it has shipped version 1.1 of 
its Globetrotter Web Publisher package for MacOS computers. 
This update is free to all owners of Globetrotter. Users may get 
complete information about the product and purchase it on the 
company’s web site at <http:/Awww.akimbo.com>. A new fully- 
functioning Demo version of Globetrotter 1.1 is also available. 

Users across the internet are raving about Globetrotter's power 
and ease-of-use. Users who have don't even know what an HTML 
tag looks like are putting up web sites with Globetrotter. 


NEWSBITS 


The 1.1 upgrade adds more than 40 new features. Like 
existing Globetrotter features, most of the new features go far 
beyond basic HTML. Examples include the ability to make any 
link into a picture link, with a picture automatically created for 
user-specified text, the ability to view table borders for tables 
published without borders, direct access to paragraph spacing, 
and arbitrary intermixing of automatically numbered and 
unnumbered outline formats. The update also fixes a number of 
problems reported by users. Complete details on the update are 
available on the web site. 

Users may purchase and download the product directly 
through Akimbo’s web site, which was created completely with 
Globetrotter. 


QUASAR KNOWLEDGE SYSTEMS 

Quasar Knowledge Systems, (QKS) Inc., the leading 
Smalltalk vendor in the Macintosh market with a PowerMac 
version available, announced that it will release Windows 95/NT 
version of SmalltalkAgents in Q1 of 1997. This will make 
SmalltalkAgents a cross-platform development tool of choice. 

SmalltalkAgents is a dynamic, integrated development 
environment based on QKS Smalltalk. In the process of developing 
a Windows version, QKS made number of enhancements in its 
virtual machine to improve performance and services. 

SmalltalkAgents is known for providing close integration to 
the host OS functionality. Its Mac version makes toolbox routines 
a trivial task. Its Windows 95/NT version will bring the same 
functionality to developers. SmalltalkAgents also allows 
developers to integrate their resources written in any other 
language via a dynamic linking library mechanism. 

For more information, check out their web site at 
<http:/www.smalltalkagents.com>. 


ICONIX ANNOUNCES AVAILABILITY OF OBJECTMODELER FOR 
NEXTSTEP/INTEL 

ICONIX Software Engineering, Inc. is pleased to announce the 
immediate availability of all 10 ICONIX PowerTools modules, 
including ObjectModeler, the leading Macintosh OOA/OOD tool, 
for the NextStep operating system on the Intel platform. 

ICONIX uses porting technology ARDI, Inc. to enable 
applications for NextStep/Intel. ICONIX applications are also 
deployed across SunOS, Solaris, HP-UX, Windows 3.1, 95 and NT, 
as well as NextStep and MacOS. Additionally, ICONIX produces a 
line of computer-based training CD-ROM tutorials on object- 
oriented software engineering, and provides a variety of on-site 
training and consulting services. The company expects to have a 
downloadable demo version of ObjectModeler/NextStep on the 
internet at <http://www.iconixsw.com> by the end of January. 


Visit MacTech Magazine’s Web site! 


http://www.mactech.com 
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And our skills are pretty sharp, too. 
We can trim your content, hone your design, and 
implement a Web site that’s...well...a cut above the rest. 
With today’s chopped budgets and pared-down schedules, you 
need JointSolutions Marketing. We have the experience, and the tools, 
to make sure your World Wide Web pages aren’t...you know...dull. 
We even have a Web server, so site maintenance and updates JOINT § JointSolutions Marketing 
don’t slice into your work time. Tel: (408) 471-1500 


; E-mail: info@jointsolutions.com 
Call us today and we'll take a whack at your Web needs. http://www,jointsolutions.com 
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Dilbert® by Scott Adams 


LET'S TAKE THE 
ENCLOSED QUIZ. 
NUMBER ONE: 

HOW MANY OPTIONS 
DO YOU HAVE ON 
YOUR TOASTER? 


PLEASE READ THESE 
BROCHURES. IT COULD 
SAVE YOUR LIFE. 


"ELECTRONICS 


DOES THAT INCLUDE 
THE TOASTER DISK 
DRIVE AND PRINTER? 
) I THINK WE CAN 


SKIP DIRECTLY TO 
« THE EMERGENCY 
APPLICATION 





© 1989 United Feature Syndicate, Inc. 
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By Nicholas C. “nick.c” DeMello 








Beyond the Basics 





DIRECTOR — SHOCKING DEVELOPMENTS 


It's 1997, the only excuse for not having built a web site for 
yourself is if you’ve been too busy making them for other folks, 
However, what are you doing to make your pages grab the 
jaded, “been there, done that” web veterans attention? Are you 
streaming real-time, 16-bit music tracks directly to your visitors 
speakers? Do you have a 200 by 500 pixel animated menu? Does 
your site offer VRML navigation? If so, you are — or should be — 
a Director Programmer. 

MacroMedia’s Director 5.0 allows you to create stand alone 
applications (called movies) by organizing and controlling multi- 
media elements (called cast members) with a language called lingo. 
Cast members can include sprites, sounds, QuickTime movies, and 
other multimedia elements. Director movies can optionally be 
converted into dramatic, interactive components for your web 
pages by the free and downloadable utility Afterburner for Director. 
These elements are supported by Shockwave, a plugin for 
Netscape 2.02 and 3.0 Final (Windows and Macintosh versions), as 
well as MS Internet Explorer 3.0 for Windows. Your visitors do need 
to download and configure Shockwave to interpret your “Shocked” 
Director files, but the process is very easy. Shockwave elements 
also have an amazingly small file size. The 200 x 500 pixel animated 
menu I mentioned above can be found on Netscape’s site — it’s 
only 20k. 

Streaming audio is definitely an attention getter. Check out 
the MusicNet pages. MusicNet is a no-cost site that allows you 
to stream Shocked audio files of top ten music tracks directly to 
your speakers. Since the music never hits disk (beyond a small 
buffer cache) you need no disk space to hear the latest 
samples. 

Putting Director files on the web is easy, but you can put a 
touch of the web into your Director programs as well. Director 
supports many plugins that expand it’s ability to manipulate 
multimedia elements, including a VRML interpreter provided by 
RealSpace Inc. By interpreting both the VRML 2.0 and 
QuickTimeVR standards the RealVR Xtra for Director lends a depth 
to your Director movies that is remarkable. It also supports 
retrieval of HTTP assets without the use of a browser, so you can 
create hybrid disk based applications that access and incorporate 
content from remote internet sites. 


UNIFORM RESOURCE LOCATORS 


~~ 


Director Multimedia Studio 
<http:/Awww.macromedia.com/software/dms/> 


MacroMedia Shockwave Developer Central 
<http://www.macromedia.com/shockwave/developer.html> 


Example of a 200 x 500 pixel Animated Menu — 20k 
<http://www.netscape.com/comprod/products/navigator/version_2.0/plugins 
/director_examples/director_example1.html> 


Music Net, Streaming Audio 
<http://www.musicnet.com/> 


RealSpace Inc., VRML 2.0 Plugin for Director 
<http://www.rlspace.com/> 


PARTING SHOTS 
Beyond C, there are many ways to express your ideas from 
programs into applications. Visit the comp.lang usenet hierarchy 
to learn about Smalltalk, Oberon, VRML, and others. If you're 
hungry for more, here are a few parting URL’s to keep you busy 
until next month. Talk to you later. 


OBERON 
The Oberon Language FAQ 


<http://www-cs.inf.ethz.ch/Oberon.htm|> 
Oberon MPW Compiler 
<ftp://ftp.informatik.uni-ulm.de/pub/systems/mac/MPW_Oberon.sit.hgx> 


SMALLTALK 

Smalltalk on Usenet 

<news:comp.lang.smalltalk> 

The Art & Science of SmallTalk — 
<http://www-uk.hpl.hp.com/people/scrl/ArtAndScience/home.html> 
TReSTHIEICEae 
<http://www.di.ufpe.br/smalltalk/> 


Visit MacTech Magazine’s Web site! 


nttp://www.mactech.com 





MACTECHMAGAZINE ® MARCH 1997 










and 
a preview 

of the next 

sion 


For Macinto 
Programme 





garcia ag 


Here’s a limited time offer that'll have you seeing double. Order the MacTech CD- 
ROM” Volume 11 and get the upgrade (expected release 1Q97) absolutely free! We'll 
even throw in the shipping costs for the upgrade. And as if that wasn't enough, 
Volume 11 is discounted too — now just $79! 


That’s right, so for less than you would normally pay for one CD... youll get two! 
So hurry, pick up the phone, fire up the e-mail, launch that fax machine, or simply 
drop by our Web site and score yourself this double-whammy of a deal! 


MacTech CD-ROM Vols. 1-11 

° 1420+ articles from all 127 issues of MacTech Magazine (1984-1995) 

e Improved hypertext and new THINK™ Reference Viewer 2.2 

e 100+ MBs of source code 

e Full version of THINK Reference 2.0 

e 80MBs of FrameWorks/SFA archives 

e Sprocket™! MacTech’s Tiny Framework that compiles and supports System 7.5 
features 

© The best threads from Macintosh programmer newsgroups, plus thousands of 
notes, tips, snippets, gotchas and much more! 


DEPOT 


Web Site: http//www.devdepot.com ¢ E-mail: orders@devdepot.com 
Phone: 1-800-MACDEV-1 e Outside the U.S. & Canada: 805-494-9797 © Fax: 805-494-9798 








By Steve Sisak 








Whenever you directly or indirectly modify code, you need 
to make sure the processor caches are synchronized in order to 
avoid confusing the processor and/or emulator. This includes not 
only self-modifying code, but also creating routine descriptors 
and loading code resources by hand. 

If you move 68k code with BlockMove on any system (68k or 
PowerPC) the caches are flushed automatically (assuming blocks 
greater than 12 bytes). Use BlockMoveData for blocks containing no 
code, since they do not require the cache flushing overhead. 

Note that on a PowerPC, BlockMove does not flush PPC 
caches at all. The only reason BlockMove flushes 68k code is for 
backward compatibility with software written before the '040s. It is 
unfortunate that a frequently-used routine like BlockMove should 
have to know anything about instruction caches. On the bright 
side, most developers do not need to copy PPC code around, since 
fragment preparation occurs within CFM. 

On a PPC machine, calls to the 68k cache flushing routines 
(including FlushCodeCacheRange and indirectly via BlockMove) do 
everything necessary to maintain 68k instruction cache coherency. 
On the original 68k emulator, this meant nothing needed to be done 
since there was no cached code. On the DR Emulator and Speed 
Emulator, these calls force the emulator to “throw out” any 
recompiled code associated with the specified code range. 

I know the different cache flushing routines are confusing 
and not very well documented. Here are some simple rules: 

If you are dealing with 68k instructions, use BlockMove or 
FlushCodeCacheRange. They both specify a range of memory and 
therefore do not require the newer recompiling 68k emulators to 
perform a complete cache flush (a very time-intensive operation 
that can degrade performance significantly.) 

If you are dealing with PPC code, you probably don’t need to 
worry about the issue because your code was probably directly or 
indirectly prepared by CFM. However, if you do generate PPC code 
on the fly, you should call MakeDataExecutable on the range. Note 
that this does more than just flushing the cache. It does everything 
(including flushing the processor's prefetch queue) necessary to 
deal with newly-generated code. 

Hope this helps clear things up. If you want more details, 
check out the tech note I wrote while I was still at Apple on the 
DR Emulator. 

Eric Traut 
Connectix Corp. 


(ALMOST) PAINLESS MIXING OF C AND PASCAL STRINGS 

It's fair to say that most of us have found ourselves in this 
situation: “The API wants C-style strings and all I have are these 
Pascsal strings!”. The typical solution is to use utilities like PtoCStr and 
CtoPStr to shuffle the bytes around. Consider the following example 
where sprintf is being used to create a menu title. 


void DescribeFile (Str255 title, Str255 fileName, Str255 
volumeName, unsigned long size) 
{ 
// Temporarily convert fileName and volumeName to C strings 
PtoCStr (fileName) ; 
PtoCStr (volumeName) ; 
// Use sprintf to describe the file eg. “File foo on bar (120.5K)” 
sprintf ((char*) title, “File %s on %s (%.2fK)”, 
(char*) fileName, 
(char*) volumeName, 
(double) size / 1024.0); 
// Convert title, fileName and volumeName to Pascal strings 
// back to Pascal strings 
GroPstr (ichar*) title): 
CtoPStr ((char*) fileName): 
CtoPStr ((char*) volumeName) ; 


As you know there’s at least one unused byte at the end of 
the Pascal string, and the string is not a literal, you can take a 
shortcut by making the Pascal strings “hybrid strings”. A “hybrid 
string” is a null-terminated pascal string. Observe: 


void DescribeFile (Str255 title, Str255 fileName, Str255 
volumeName,unsigned long size) 
{ 
// Convert fileName and volumeName to hybrid strings 
fileName [fileName [0] + 1] = ‘\0O’; 
volumeName [volumeName [0] + 1] = ‘\O’; 
// Use sprintf to describe the file eg. “File foo on bar (120.5K)” 
// Note that we skip the first byte of the hybrid strings 
Sprintf ((char*) &title [1], “File %s om %s (%.2fK)", 
(char*) &fileName [1], 
(char*) &volumeName [1], 
(double) size / 1024.0); 
// ‘title’ is not yet a hybrid string, it has an undefined length byte 
title [0] = strlen ((char*) &title [1]); 


Remember, you can’t always get away with this. In the 
above we know that title, fileName and volumeName are non- 
const strings with room for 255 characters. Since ‘fileName’ and 
‘volumeName’ will never be more than 63 and 27 bytes 
respectively, we’re sure there is room to add the length byte to 
the end. Similarly, ‘title’ won’t break 130 bytes. 

Damon Cokenias 
<http.//www.netgate.net/~cokenias> 
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http://www.mactech.com 


(...and we really mean now.) 


Think of it as your source of news and announcements in the 
MacOS developer community. Loaded with up to the latest news, 
and constantly updated with developments in our industry. 


MacTech NOW™ brings you up to speed on everything you need to 
know — instantly! And thanks to our new “fast-download” design, 
you'll get to the information you want in seconds. 





Give it a spin! Check it out today and get access to over 1500 pages 
loaded with news, tips, programming secrets, product reviews, and 
much more. And for those of you looking for some kicks, there’s the 
ever popular “Programmer’s Challenge” section where you'll get to 
bang heads with the best in the community. 


Log on to MacTech NOW. Things are happening right now, and you 
should be aware of them. 
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ANNOUNCI 


Developer Depot 30 day Money Back, Price and 

Satisfaction Guarantee 

Developer Depot products are sold with a 30 Day money back guarantee on 
user satisfaction, lower prices and against defects. If, for any reason, you are 
not satisfied or find the same product at a lower price within 30 days, please call 
Customer Service at 800-MACDEV-1 and request a Return Merchandise 
Authorization (RMA) number to get a full refund or the difference in price 
(where applicable). You must return undamaged product at your expense, 
including all its original packaging, documentation and the blank warranty card 
if applicable. Developer Depot will replace defective product upon receipt of 
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the defective merchandise. Please remember to back up your data before instal- 
lation of any new hardware, software, or peripherals; we cannot be responsible 
for any lost data. Policies, item availability, and prices are subject to change 
without notice. The price in effect when we receive your order will be the price 
that you are charged. We are not responsible for any typographical errors in this 
or any other catalog, nor for any misstatements from any vendor. Purchase 
orders are also accepted but must be in writing, signed, come with a contact 
person and a telephone number, and mailed to P.O. Box 5200, Westlake Village, 
CA 91359-5200. Faxed copies and purchase order numbers alone are not 
acceptable. 


Developer Depot makes no other warranties. All other warranties, either expressed or implied, including the implied warranty of merchantability and fitness for a particular purpose are 


disclaimed. Developer Depot shall not be liable for any direct, special, incidental or consequential damages including lost profits, from any delay in sang or for any 
arising from the use of any product sold through Developer Depot. The limit of direct damages, if any, shall not exceed the purchase price of the product.© 19 
rights reserved. Any unauthorized duplication is in violation of federal laws. Developer Depot is a registered trademark of Xplain Corporation. 
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Limited time offer 
olume 11 NOW, and get a 
upgrade to the soon- 


to-be-released Volume 12! 
Free shipping on the upgrade! 





Best of MacTutor 
The Best of MacTutor Collection, Vols.3-5. 


List $99 Our Price per set (BMTBEST). 











subscriptions: US magazine: for 12 issues (MTYRDM 
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MacTech CD-ROM Volumes 1-11 


e 1420+ articles, from all 127 issues of MacTech Magazine (1984-1995). 

e Improved hypertext, and a new THINK Reference Viewer — for lightning quick 
access! ¢ New hyperlinks between articles. ¢ 100+ MB of source code — 
use them in your own applications, with no royalties! ¢ Full version of THINK 
Reference™ -— the original online guide to Inside Macintosh, Vols. I-VI. 

e 80MB of FrameWorks/SFA archives. The most complete set of FrameWorks 
archives known. ® Sprocket™! MacTech’s Tiny Framework that compiles 

uickly and supports System 7.5 features. e The best threads from the 
Macintosh programmer newsgroups plus thousands of notes, tips, snippets, 
and gotchas. 

e Popular tools that Macintosh programmers use to increase their productivity 
and much more! 


List $89.00 Our Price SMTCD11 


aclech Mouse Pad 


slide on this! With an extra-large surface (11” by 10”) and a deluxe sleek 
plastic coating, you'll be zooming across your screen in no time at all. 
peed limit not enforced! 


ur Price AMTPAD 
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AppleScript Software 


Development Toolkit 1.1 
by Apple Computer, Inc. 


e AppleScript language, system software 
extension, and script editor. 

e FaceSpan 1.0. 

e Developer's redistribution license for 
AppleScript System software extension and 
FaceSpan runtime code. 


Our Price $49 (SASDT) 
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css ff = Apple Media Tool | 
Programming Environment 2.0 
by Apple Computer, Inc. 


e This object-oriented language and application framework 
allows programmers to customize features used within the 
Apple Media Too! authoring environment. 
ll-fre 
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a e Includes an expanded Apple Media Language (AML) class 
CAN. MACDEV, j library, incremental compiling and linking of AML code, faster 
UVUTTIAVWEY" I debugging facilities, Macintosh Programmers’ Workshop 

23381] (MPW), and user-oriented documentation written from an 
AMTPE developer’s perspective. 


e Portable across 68K, Power Macintosh, and Windows platforms. 
Our Price $995 (SAMTPE) 
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Object-Oriented Fundamentals 1.1 
by Apple Computer, Inc. 


e DU’s multimedia Object-Oriented Fundamentals course enables 
you to easily make the paradigm shift from procedural to 
object-oriented design. It will introduce you to the entire object 
skill set, from general concepts through analysis and design. 
This course includes a “lite” version of Metrowerks 
CodeWarrior integrated development environment for use in 
the labs. This course also includes a copy of the book Learn 
C++ on the Macintosh by Dave Mark. 


Our Price $245 (SOBORFU) 


Newton Toolkit 1.6 
by Apple Computer, Inc. 


With Newton Toolkit, you can easily 
create software that runs on any 
Newton PDA, including Apple’s 
MessagePad and Motorola's Marco 
e Now supports Newton 2.0. 

e Dynamic Language Eases 


Newton Programmer’s 


Guide for Newton 2.0 
by Apple Computer, Inc. 


e The Newton Programmer’s Guide consists of two volumes 
covering the Newton System Software, and one volume 
covering Newton Communications. 

e The two-volume set, Newton Programmer’s Guide: System 
Software, is the definitive guide and reference for Newton 
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Development. _ | programming. This set of volumes explains how to write aN 
* Allows you develop applications interactively. Newton programs and describes the system software rou- mm 
¢ New Compiler Enables Faster Applications. tines that you can use to do so 
Newton Toolkit 1.6 Our Price 29d (SNETO) © The Newton Programmer's Guide: Communications, J = 
Newton Toolkit Update 1.6 Our Price $49 (SNETOUP) describes the Newton communications system software 
for version 2.0. 
Our Price $149 (BNPGEN) 


Web site: http://www.devdepot.com ® E-mail: orders@devdepot.com 





QuickTime VR 2.0 Authoring Tools Suite 
by Apple Computer, Inc. 


© QuickTime VR is a cross-platform software from Apple which 
enables webpage designers and professional developers to cre- 
ate new multimedia products and webpages incorporating 
QuickTime VR content. With QuickTime VR, users interactively 
navigate through 360° views of space, and explore three 
dimensional objects on Macintosh or Windows-based personal 
computers. 

e The QuickTime VR Authoring Tools Suite is a set of Macintosh 
tools to create and link panoramas and objects from photo- 





Virtual Reality Programming with 


graphic, digital, video, or computer generated images. QuickTime VR 2.0 

e Included is a complete set of documentation for planning, by Apple Computer, Inc. 
designing, photographing, and creating QuickTime VR panora-_¢ Virtual Reality Programming Book/CD-ROM for QuickTime VR 
mas and objects. The authoring tools also allow you to link ° Enables you to write C and C++ programs using QuickTime VR 
objects to panoramas using clickable hot spots. e Allows QuickTime VR to be used in games, multimedia titles 

Included on the CDs are: and other programs. 

e A software tool (MPW-based) that stitches and blends adjacent © QuickTime VR 2.0 objects can be zoomed in on, panned, or 
images into a panoramic PICT file. linked with hots spots. 

e A software tool (MPW-based) that dices and compresses e Both panoramas and objects have hot spots linked to World 
panoramic PICT files to less than 100 KB (low resolution) per Wide Web URLs. 
panorama. Our Price $39.95 (svrPar) 


e A scene editor (HyperCard-based) to create QuickTime VR 
scenes by adding and positioning nodes, hot spots, linking 





nodes together, and for linking QuickTime VR objects to . . . 
eee : : Multimedia Authoring 

e A variety of utility tools for formatting the data into the with Apple Media Tool 
runtime software. by Apple Computer, Inc. 


Due to a revolutionary distortion-correcting algorithm, QuickTime Apple Media Tool offers new multimedia users a way to get 
VR panoramas and objects maintain a normal perspective when started creating interactive multimedia with minimal learning 
the user moves the mouse. The speed of the algorithm allows up __ time. This self-paced tutorial will make Apple Media Tool (AMT) 


to 24-bit color images. Both vertical and horizontal panning can even easier to understand and to use. Using this tutorial, you w 
occur at fast speeds. create a realistic multimedia project using exciting techniques 
Our Price $395 (SQTVRATS) such as QuickTime movies, animation and more. A demo versi 


of AMT is included and can be used for the exercises. Training 
Format: Tutorial with labs. 


Our Price $49.95 (SMWAMT) 
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® Apple Dylan 





a dynamic object oriented language and development environment 


PRODUCTS 


| QuickTime Developer’s Kit 2.0 Apple Dylan Technology Release 
\ by Apple Computer, Inc. by Apple Computer, Inc. 
| e QuickTime 2.0 Extension, QuickTime Power Macintosh e Contains a PowerPC-native prototype version of a developmer 
vt Extension, and QuickTime Musical Instruments extension. environment based on the Object Oriented Dynamic Language 
ae ' e Utilities like MoviePlayer 2.0, 16-bit Audio Compression, etc. (OODL) Dylan. Developers will be able to produce code target: 
Sawea’ ) e Sample content such as MPEG Movies, Music Movies, Time- ing both 680x0 and Power Macintosh systems. 
le Code Movies, and 60 field per second movies. e Automatic memory management. 
ant e Includes software-only playback features such as faster 2x e Application framework and user-interface builder. 
ml playback mode for current compressors, Apple Cinepak com- e High-level exception handling. 
ot \ pressor, 1-bit fast dithering, network tuning, load-into-RAM e Cross-language support for C code and APIs. 
: option, and Photo CD support. CD & Online Documentation Our Price $39.95 (SADTRO) 
Our Price $99 (SaTDK) CD &Hardcopy Our Price $59.95 (SADTRH) 


1-800-MACDEV-1 © Outside U.S. & Canada 805-494-9797 © Fax: 805-494-9798 





by Metrowerks 





by Metrowerks 
e Source code control system for the Macintosh. 


e Based on and compatible with Microsoft Visual SourceSafe version 4.0. 
e Works with any type of binary file including graphic, database, library and exe- 


cutable files. 


e Includes support for multi-platform projects, security features, reverse delta ver- 
sioning of files, comment areas for each revision, project analysis and reporting 
tools. Sold on a subscription basis with two future product updates. 


e Includes a 1 year MacTech subscription. 


Our Price $399 scomcr) 
SEE RELATED CATEGORY: Dev. Environments 


Discover Programming for Macintosh 
by Metrowerks 


e Includes full version of CodeWarrior along with three online 
tutorial books and Dave Mark’s “Learn C on the Macintosh” 
converted to AppleGuides. 

e Includes C, C++ and Object Pascal compilers for generating 
68K Macintosh code, source-level debuggers, object-oriented 
frameworks (PowerPlant, MacApp), Apple’s MPW, complete 
online documentation and source code examples for all lan- 
guages and platforms. 

e The IDE software has been localized in eight languages plus 
English. This product is not sold as a subscription. 

e Includes a 3 month subscription to MacTech 
Magazine. 


Our Price $79 (ScwDISCMAC) 
SEE RELATED CATEGORY: Dev. Environments 
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CodeWarrior Gold 11 


e New improved IDE - graphical browser view, new project manager, global preferences and 
an improved external editor, easy-to-use IDE supports C/C++, Object Pascal and Java. 

e Full Java toolkit: project manager, linker, editor, class browser, source-level debugger, 
applet viewer and more! Everything you need for industrial-strength programming. 

e New Object Pascal cross-compiler and New MPW Object Pascal compiler. Develop for 
Macintosh, Power Macintosh, Windows 95, Windows NT, Magic Cap and BeOS. 

e Includes early release ActiveX Support and new VSC interface Version Control Support. 

e Includes improved JAVA support, an alpha version of the new Version 2.0 CW IDE, on-line 
books, extensive reference material and Apple Guide files for easy navigation through 
tutorials and examples. Two free updates and technical support included with registration. 


Our Price $399 (SCWGOLD) 


SEF RELATED PRODUCTS: ¢ Code Manager e Inside Power Plant ¢ Inside CodeWarrior 9 
¢ C++ Programming with CodeWarrior ¢ PowerMac Programming Starter Kit ¢ Discover 
CodeManager Programming for Macintosh ¢ Learn C on the Macintosh ¢ Metrowerks CodeWarrior Programming 





CodeWarrior for BeOS DR2 

by Metrowerks 

e Start programming for the new, innovative Be Operating System 
(BeOS) with complete set of Codewarrior tools 

e BeOS-native Integrated Development Environment (IDE) with all the 
familiar CodeWarrior features at your fingertips 

¢ A BeOS PowerPC compiler and linker, an editor w/syntax color and 
styling, and a source-level debugger 

© BeOS header and libraries, complete documentation, useful C++ 
classes, and sample code 

e The Be Operating System DR8.2 for Power Macintosh allows you to 
run and program for the BeOS on a 603 or 604 PCI based 
PowerMac 


Our Price $1 49 (scwrB) 


CodeWarrior Wear (XL only) 

You live it, you breath it... you might as well wear it! 
e Black CodeWarrior Sweatshirt: 

Our Price $29.95 (acwswean 

e “Blood, Sweat & Code” black short-sleeve shirt: 
Our Price $9.95 (AcwsBLOOD) 

e Hawaii Five-O shirt: 

Our Price $7.95 (AcWHAWAl) 

e Hat: Our Price $1 4.95 

Please Specify: Black (ACWBHAT) or White (ACWWBHAT) 
e Winter Hat (see Web site) 

Our Price $14.95 (AwinHAT) 
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by Symantec Corporation 





Symantec C++ for 68k 


by Symantec Corporation 


e The standard in development languages. 

¢ Powerful combination of fully integrated visual tools and the 
latest in C and C++ compiler technology. 

e Provides an object-oriented approach to application develop- 
ment. 

e Write code that is extensible, reliable, and maintainable. 
Includes: Integrated Environment with full source-code debug- 
ging, Incremental Linker which eliminates long link times, 
THINK Class Library, AppleEvents, Visual Architect™ , THINK 
Inspector, Project Models, Source-Code Control with integra- 
tion with Apple’s SourceServer (included), Support for 
scripting, Powerful Standard Libraries which includes I/O 
Streams, ANSI standard C library, and sample programs. 

e Full source code is included — Create applications that run on 
68K Macs and Power Macs (emulated). These applications can 
easily be migrated to native Power Mac, by trading up to 
symantec C++ for Power Mac. 


List $299 Our Price $99 (SSYMCPP68k) 


FORTRAN 90 for Power Macintosh 

by Absoft Corporation 

Absoft F90 SDK is a complete native ANSI FORTRAN 90 development 

kit for Power Macintosh. Includes a globally optimizing compiler 

(includes 604 optimizer). 

e Graphical debugger, browsers, array display, perfor- 
mance profiler, linker, MRWE application mainframe, 

e MIG graphics library, Absoft Create Make, several utili- 
ties, the latest version of MPW and illustrated documentation. 

e Whole array operations, modules, interface blocks, and 
user-defined types or data structures. 

e Dynamic memory allocation and new control constructs. 

e F90 is link compatible with Absoft F77, C++, MrC and 
CodeWarrior. It is fully compatible with Toolbox, MPW tools, and 
most third-party products. 


Our Price $799 (SF90) 


Symantec C++ 8.5 


e Native for Power Macintosh. 

¢ Develop full-featured Power Macintosh applications quickly and easily! 

e Environment includes: a true native Power Mac implementation of the C++ 
language, MrC/MrC++ compilers for fast Power Mac executable code, 
Visual Architect for fast, easy GUI generation, a new THINK project manage- 
ment system that supports complex applications, a new editor/browser , a 
powerful, easy-to-use source code debugger. 

e Also includes: The industry-standard THINK Class Library! 

e Next two updates free when you send in your registration card and more! 


List $499 Our Price $349 (ssymcpp) 


SEE RELATED PRODUCT: Symantec C++ Programming, Learn C-++ on the 
Macintosh, Programming in Symantec C++, Mastering theTHINK Class Library. 





Power MachTen—UNIX 


by Tenon Intersystems 


e Dynamically linked shared libraries, memory mapped file access 
and integrated UNIX and Macintosh development tools. 

¢ BSD 4.4 and conforms to the Federal Information Processing 
Standard 151-2 (the POSIX FIPS). 

¢ Pre-emptive multitasking for UNIX applications and includes a f 
featured high-performance TCP/IP protocol stack that supports 
multi-homing and multi-casting, features not yet available even 
with Apple’s new Open Transport. 

e A complete UNIX software development environment with a 
source-level debugger and C, C++, and Fortran compilers all 
generating native PPC code. 

¢ Also included is a high-performance X server and complete 
X11R5 X. 


Our Price $695 (Sm10PPc) 
Internet Related 


SEE RELATED CATEGORY: 


F77 SDK 


by Absoft Corporation 

For Power Macintosh includes a globally optimizing native 
compiler and linker, native Fx™ multi-language debugger, and 
Apple’s MPW development environment. 


e The compiler is a full ANSI/ISO FORTRAN 77 implementation. 

¢ Includes all MIL-STD 1753 extensions, Cray/Sun-style 
POINTER, and several FORTRAN 90 enhancements. 

e MRWE, Absoft’s framework library is included in the MIG 
graphic library 

e Supports the native Macintosh PPC toolbox. 

e Includes Absoft’s Fx debugger which can debug intermixed 
FORTRAN 77, C, C++, and PPC assembler. 

e The linker compiler, and debugger all run as native PPC 
tools, and produce Macintosh PPC executables. 


Our Price $699 (SF77) 


1-800-MACDEV-1 ¢ Outside U.S. & Canada 805-494-9797 ¢ Fax: 805-494-9798 














NS BASIC 3.5 for the Newton with Visual Designer 
by NS BASIC Corporation 


¢ A fully interactive implementation of the BASIC programming language. ¢ Runs entirely on the Newton — 
no host is required. 

¢ Create files, access the built-in soups, and the serial port for input and output. ¢ Work 
' directly on the Newton, or through a connected Mac/PC and keyboard. 

¢ Get the BASIC Internet Tool, available at no charge to NS BASIC users from www.nsba- 
! sic.com. Release Notes with sample code are available from the same location. ¢ Runs on 
any Newton MessagePad 130 with NS BASIC and the Newton Internet Enabler. Also runs on 
MP 1201s with NOS 2.0 that have full memory available. ¢ Write short programs to access News, mail and the web. 


List $99 Our Price $94.99 (snsBasic) 


ieee Presenting Magic Cap, A 
Guide to General Magic’s 
Revolutionary 


Communicator Software 
by Barbara Knaster 


e Perfect for novices as well as experts 
who want to take full advantage of Magic Cap. 

e Step through its screens, see how it works, and learn 
ways to use it. 

e Describes the power of smart messaging to customize 
the way you handle e- mail, a name card file that 
learns how to keep track of your contacts, a datebook 
that performs like a faithful assistant, and countless 
other abilities. 


List $16.95 Our Price $15.25 (epresmacic) 


ach'en Code Builder 
y Tenon Intersystems 


acintosh Software Development Tool Suite for Building Mac, 
NIX, and X Applications. 

UNIX and Mac development tools 

AfterStep (NeXT-style) X Window desktop. 

C/C++, Objective-C, Java, Ada95, Fortran77 

Mac Toolbox (SDK) bindings to produce native Mac apps. 
Perl, MacPerl, tcl/tk, expect, bash, csh, sh, alpha, BBEdit 
Lite, emacs, sample apps. 

Introductory Our Price $99 (SM10CODEB) 





ersonal MachtTen for 68K Macs 
y Tenon Intersystems 


e MachTen UNIX for Macintosh (from Classic on up, including 
PowerBooks and Duos) 


Think Pascal Version 4.0 
by Symantec Corporation 


¢ A Mach-based Berkeley UNIX with pre-emptive multi-tasking ® Great for professionals and students 

e Extends the Mac OS with UNIX networking and software e Fully integrated for rapid turnaround time — take advan- 
development tools. tage of System 7 capabilities 

¢ Built-in internet services include domain name service, POP * Supports large projects, enhanced THINK Class Library, 
mail service, internet routing, SLIP & PPP. and Web service. er aaa superior code generation, and 
Our Price $495 (SM10PER) Also Available: MachTen cepa 


e Includes four Macintosh disks, a user manual, and an 
XWindows Our Price $350 (SMACHX) object-oriented programming manual. 
SEE RELATED CATEGORY: Internet Related Our Price $165 (SPASCAL) 







_Here’s a list of all available products. 
\ / For full product descriptions please see our Web site, or feel free to call, 
‘~~ <“ fax, or E-mail us. 


PRODUCT CODE LIST PRICE OUR PRICE 













LPA MacProlog Developers Edition SLPAD 1500.00 995.00 
LPA MacProlog Programmers Edition SLPAP 745.00 495.00 
LS FORTRAN SLSFORT 695.00 595.00 
Mac FORTRAN II SFORT2 ~ 595.00 549.00 
Professional MachTen for 68k Macs SPROM10 695.00 695.00 






Web site: http://www.devdepot.com @ E-mail: orders@devdepot.com 
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Roaster Subscription 
By Natural Intelligence Inc. Get the most out of 
Sun’s new Java™ Programming Language! 


e Write, test and run Java applets on the Macintosh in a 
full-featured Mac development environment 

e Features include: project window that includes a finder-like 
view of packages, Macintosh native compiler, source code 
editor with powerful search features and intuitive use interface, 
runtime engine for quick and easy applet testing. 

e Requirements: PowerPC based Macintosh, CD-ROM. 

e Price includes the current DR 2 release and the next two 
non-developer releases. 


List $399 Our Price $299 (sroasn) 
SEE RELATED CATEGORY: Dev. Environments 


THE DEVELOPMENT 
ENVIRONMENT FOR JAVA“ 





Roaster 
By Natural Intelligence Inc. 


e Price includes the current DR 2 release 
and the first non-developer release. 


List $179 Our Price $1 29 (SROASTI) 


Symantec Visual Café 
by Symantec Corporation 


symantec Visual Café for Macintosh or Windows gives developers the fastest, most pro- 
ductive visual programming environment ever for creating Java applets and applications. 
e Drag and drop visual programming, easy to learn and use. 

e Flexible development environment, two-way programming. 

¢ Comprehensive component library, create re-usable templates. 

e Extensive Java toolset and the fastest compilers. 


Our Price $199 (svcAFEMAC) OR Our Price $199 (svcAFEWIN) 


OOFILE Reporter Writer 


by A.D. Software 

This is a full embedded report-writer, allowing you to preview page-by-page and either print or save as plain text, HTML or 
RTF. Multiple levels of breaks, database views and headers and footers are provided using a clean object-oriented design. 
Incudes RAM-based version of OOFILE database. Included in full OOFILE Platform Bundle. Price includes 1-tear subscription. 
Saving to file without preview of printing is cross-platform-run on your Mac/Win/Unix server and create Web Pages. 


Our Price $500 (SOORW) 


TCP/IP Scripting Addition 


iy | Mango Tree Software, inc.” 











by Mango Tree Software 

e Award-winning AppleScript scripting addition 

e Allows you to write scripts using MacTCP™ commands in AppleScript™ . 

e Send e-mail or files through a script, check if users are logged on (via Finger), automate 
FTP, Gopher, NetNews, Telnet, and LPR, verify links in HTML documents, and quickly write 


TCP/IP 
Scripting Addition’ 
The internet Scripting Solution 









many other TCP/IP client-server programs. 
¢ Works with AppleScript, MacTCP 2.0.4 and Open Transport 


Our Price $49 (sTcP) SEE RELATED CATEGORY: Scripting 







ObjectSet Mail SDK for Macintosh 


by Smartcode Software 

e Provides easy-to-use MIME, SMTP & POP3 APIs. 

e Royalty-free C++ classes for 68k and Power Macintosh 
e Compatible with ALL leading e-mail products. 

e ideal for use in Internet and Intranet environments. 

e Samples with documented, reusable source code. 

e Windows, UNIX, and multi-platform versions available. 


Our price $495 (sosmspk) 





1-800-MACDEV-1 © Outside U.S. & Canada: 805-494-9797 © Fax: 805-494-9798 


FaceSpan v2.1 
by Digital Technology International 


e Develop integrated software, make stand alone applications, create friendly interfaces. 
e Develop quick prototypes, print multiple pages with sophisticated layouts. 

e Script essential elements of the FaceSpan application - Enhanced save options. 

e Play and record sounds as either “snd” resources Or as “AIFF” files. 

e Create miniature or complete apps that run on either Power PC or 68k computers. 

e Use precise time measurement for implementing timed behaviors - New properties. 

e Proportionally scale PICT images -Align images in a pictbox -Automate any application. 
© Monitor and respond to low-memory situations-Increased support for Frontier UserTalk! 


List $299 Our Price $279 (SFACESPAN) 





ript Debugger 
Late Night Software Ltd. 
\ powerful and flexible AppleScript authoring tool — get the most from AppleScript! € ScriptDebugger 
Advanced debugging environment offers single-step script execution with breakpoints. __ VERSION, 1.0 


Script Debugger dictionary browser features a graphical view of objects provided by 
criptable applications. 

ncludes Late Night Software Scripting Additions — a collection of more than 70 new 
\ppleScript commands, and Scheduler, a utility that allows you to launch scripts at pre- 


jetermined times. | | USER'S GUIDE 
‘ist $129 Our Price $119 (SDEBUG) | 


For professionals, for novices, for webmasters, for solutions providers, there’s only one 

serious choice. Scripter! | 

e Scripter and FaceSpan work together: one click opens your FaceSpan script in Scripter, 
another sends it back. 

e Debug handlers without modifying your scripts using the Call Box. 

e Applet simulation, live editing, Object map, associated terminology. 

e Search backwards, block generators, more navigation shortcuts, more drad-and-drop, 
and an even more enhanced trace log. 

e ScriptBase is now included: stores your data and media elements (frequently used val- 
ues, text, pictures, scripts, HTML, headers, file references) and share them between 
scripts all with a special new browser. 

e Easily write and compile scripts that have handler declarations and other vocabulary 
specific to a particular scriptable application. © Scripter is the natural companion to 
AppleScript for users at all levels of proficiency. Dont write scripts without it! 


List $199 Our Price $179 (sscRIPTER) 


Scripter 2.0 
NEW 2. Oo: by Main Event Software 








Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT CODE LIST PRICE OUR PRICE 














CodeWarrior Discover Java SCWDISCJAVA $99.00 $99.00 
DogPatch SDOGPATCH 299.00 199.00 
PreFab Player SPLAYER 95.00 95.00 
ScriptBase SSCPTBASE 59.00 59.00 
ScriptWizard SWIZ 89.00 84.95 
SmallTalkAgents SSTRA 695.00 695.00 





Tenon Ported ApplicationsCD SPORTED 50.00 49.95 





Web site: htto://www.devdepot.com ®° E-mail: orders@devdepot.com 
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BBEdit 4.0 


by Bare Bones Software 


e A powerful, easy-to-learn text editor. 

e Adds new features for HTML coders, including a spelling 
checker and HTML tag palette. 

e Accelerated for Power Macintosh; dragging supported everywhere; 
Internet Config aware; PowerTalk aware. 

e Integrated support for Symantec’s IDE, Metrowerks CodeWarrior, THINK 
Reference 2.x, MPW ToolServer, and most other environments. 

e Many UNIX style tools, including “grep” searches, file comparisons, and sorting. 
Multi-file search and replace. 

e PopUpFuncs feature lets you jump to a function from a menu. 


List $119 Our price p¥4 (SBBEDIT) | SEE RELATED CATEGORY: Internet Related 






















QUED/M 3.0 
by Nisus Software 


e The programmer’s text editor that defined the industry standard for 
speed and efficiency. 

e PowerPC native. 

e Features integrated support for Symantec C/C++, Metrowerks CodeWarrior 6, 
and MPW. 

¢ Supports all the major development environments on the Macintosh. 

e Dozens of powerful editing features, including unlimited undo and redo, macro 
language, scripting, text folding, ten editable/appendable clipboards, markers, 
displaying text as ASCII codes, dynamic coloring of C/C++ keywords/comments, 
rectangular and non-contiguous selection. 

e Includes Celestin Company’s APPRENTICE 4. 


List $149 Our Price $89 (SQUEDM) 








OpenGL for the Macintosh 


by Conix Graphics 
e Powerful 3D graphics library, 100% OpenGl compliant. 
e Portable to more platforms than any other API. 

e Delivers workstation-class performance to the Mac. 

e RAVE hardware support gives you the speed you need. 
¢ Multi-processor capability & works with ALL compilers. 


Our Price $279 (SOPENGL) 





Movie Cleaner Pro 1.3 
by Terran Interactive 





e Compress QuickTime movies 

e Powerful and easy-to-use 

e Includes: drag and drop batch processing, suspend and 
resume, adaptive noise reduction, IMA audio compression, 
high quality crop and resize, A/V fades, gamma correction, 
de-interlacing and more! 

e Automatically suggests the best settings for your application. 

e Great for both beginners and experts 

e Essential for CD-ROMs or Web sites 


Our Price $189.95 (smovie) 
SEE RELATED PRODUCTS: Quick Time Official Guide 





by Power Box 

Bee-one lightens your load on the road by adapting relational 
databases developed under 4D° to the Newton Platform. 
Once the program is installed on both the Macintosh and the 
Newton, it takes 4 simple steps to use Bee-one! 

e Database transfer, Set-up, Use, and Synchronization. 


Our Price p13 (SBEEONE) 





1-800-MACDEV-1 ¢ Outside U.S. & Canada: 805-494-9797 © Fax: 805-494-979 





c-tree Plus® Database Handler 
by Faircom 


a 
ia POD AGI Unsurpassed Cross 
> ot Av hw Platform Tools for 
Mac Developers! 


e Full C Source. 

e Client/Server 
Option. 

e Over 16 years 
proven reliability. 

e Concurrent simultaneous access of Mac/PC files. 

e Superior throughput and performance. 

e Unparalleled scalability and flexibility. 

e Fixed/Variable length files. 


Our price $895 (SCTPDH) 









Legtop Podeum 


by Rach Inc. 

A combination working 
platform and carrying case 

that allows laptop owners a 

Safe and comfortable way to 

use their computer in a variety 

of mobile and field environments. 


Our Price $7 9.95 (ALGTPPOD) 











CronManager 

by Orchard Software r-tree Report Generator ) 

e Implements the UNIX Cron facility. by Faircom hi 

e Open any Macintosh file on a given date and time. Handles virtually every aspect of GF, 

e Simple interface. report generation: le 

e Works with any Macintosh file. e Complete C source. as 

e Cron Manager bundled with CLimate, Complex multi-line reports. f ud 
Our price $26.95 (SCRONMGR) e Multi-file access. co am 

© Complete layout control. | -_ 
e Conditional page breaks. 

CPU Doubler ——— a 

by Orchard Software Diy | $ 1) re 

e Performance enhance- : 9 rear ee plice 3 aay oe 
ment utility for the j rep ing Option pa 
Macintosh 9 Se orem BG 

e Increases the speed Of Jf @custom Pertormance NeoAccess 
your computer by 100% by Neologic op, 

e Works on both the ec sti = ° Full-featured object database engine for use in Macintosh, 1 
PowerPC and 68K DB) ectute beckgrouns-Onty | se startap Windows, Unix and DOS based C++ applications. (a 
Macintosh. = ¢ Extended binary trees and binary search algorithms tuned for eee 





¢ Manages computer | short access times; dynamically combined, collapsed, and com- 
throughput using a proprietary scheduling pressed indices; object caching for instant access to previously 


AR 


algorithm. : om used objects. 
e Ensure optimal performance and compatibility. e Build fast, powerful applications in record time! j 
Our Price $79.95 (SCPU2X) Our price $749 (SNEO) 











Guide Composer” 1.2 

by StepUp Software ; a ie 

¢ Create powerful Apple Guide help systems for any new or existing Macintosh wi 
application. ‘a 

e Provides a WYSIWYG development environment: Guide content is developed $s TWARE | 
in Guide windows. 

e Design topics, phrases, and panels in the same format as the user will use them. Features are WYSIWYG interface, Topics, 
phrases, and hierarchical phrases, Coach marks, Fully-Integrated with Apple's Guide Maker (distributed with Guide 
Composer), compiles scripts automatically, PICTs in Panels, Generated Guide scripts are modifiable. 

e FREE Update to all registered Guide Composer users. Demo is available at http://www.guideworks.com/. 


Our Price $99 (SGCOMP) 
SEE RELATED PRODUCTS: AppleGuide Complete, Danny Goodman’s AppleGuide Starter Kit, Real World AppleGuide 
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Web site: htto://www.devdepot.com ® E-mail: orders@devdepot.com 
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Memory Mine 
by Adianta Inc. 


e Monitor heaps, identify problems such as memory leaks, 
and stress test applications 

e Active status of memory in a heap is sampled on the fly: 
allocation in non-relocatable (Ptr), 
relocatable (Handle) and free space is shown, as are heap 
corruption, fragmentation, and more 

e Allocate, Purge, Compact, and Zap memory lets users 
stress test all or part of a program 


List $99 Our Price $94.99 (smeMMINe) 
SEE RELATED CATEGORY: Dev. Environments 


vooD00 
by UniSoftware Plus 


e Version control tool for the simple and clear management of projects in which files 
are created in numerous versions (variants and revisions). 

e Allows both variant and revision control, and it manages not only variants and rev 
sions of single files, but of a whole software project (multi files, multi users, multi 
variants, access rights, etc.) 

e Graphical user interface and is not only suitable for mere source code control but can handle all different kinds of files with 

amazing compression rates: typical size of delta between arbitrary files 5% 

e Please note special prices for multiple copies: 


Single license $229 (svoon001); 2 pack $359 (svoop002); 5 pack $799 (svoon005): 


10 pack $1369 (svo0D0010): 20 pack $2399 (svo0p0020) 


Additional pricing available on request. 
SEE RELATED CATEGORY: Dev. Environments 





: ae : ae 
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OC High performance runtime stress testing for applications. 
by Onyx Technology 


e Tests include heap checks, purges, scrambles, handle/pointer validation, dispose/release 
checks, write to zero, de-reference zero as well as other tests like free memory invalida- 
tion and block bounds checking. 

e Extremely user friendly — ideal for non-programmer testers. 

e Also available in Japanese. 


List $99 Our price $94.99 (sac) 
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StoneTable This product can now be ordered in 3 different packages. 
by StoneTablet Publishing 
e Replaces all functions found in list manager 68K StoneTable 






e Variable size columns/rows; different font, size, style, forecolor, This includes StoneTable, StoneTableExtra for Think Pascal, Think 
backcolor per cell; sort, resize, move, copy, hide columns/rows; + ©, MPW C, MPW Pascal, CodeWarrior C, CodeWarrior Pascal 
edit cells/titles in place; titles for columns/rows; multiple lines Our price $175 (SSTONE68) 
per cell; grid line pattern/color; greater than 32k data per 
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table; up to 32k text per cell; support for balloon help and 
binary cell data. Versions for Think C, Think Pascal, MPW C, PPC StoneTable | 
MPW Pascal, CodeWarrior 6 C. This includes StoneTable PPC, StoneTableExtra PPC for Think 






C, MPW C, MPW Pascal, CodeWarrior C, CodeWarrior Pascal 
Our price $175 (ssTONEPPC) 





a 


StoneTable Extra 


by StoneTablet Publishing 
e Drag selected cells within table or to other tables. 68K/PPC StoneTable 


¢ Add rows as part of drag; popup menus or check boxes in _—*(["cludes both packages 
cells; variable width grid lines; move/drag/resize table in Our price $325 (SsTONEFAT) 


window; clipboard operations on multiple cells. 
e Requires Stone Table. 
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TOOLS, LIBBARE 







1-800-MACDEV-1 © Outside U.S. & Canada: 805-494-9797 © Fax: 805-494-9798 








oftPolish CD-ROM 


ly Bare Bones Software 


The essential tool for software quality assurance on the Macintosh 
Helps you identify inconsistencies with Apple’s user interface guidelines, 


misspelled words, missing resources, and other mistakes 


Provides tools to put the finishing touches on software distribution 


packages prior to release 


Works independently of any programming language or environment 
» Ideal for sanity checking software throughout the development process. 


List price: $99 Our price: $89 (SSOFTPOL) 


owerTap 
vy Fortner Research 


» Offers a simple method of implementing multi-processor 
capabilities to any application. 

» Creates applications that are compatible with Apple's 
DayStar and other multi-processing computers. 

e Compatible with Fortran, C, and C++ programming 
environments. 

e Adjustable slide bar controls the level of CPU-sharing. 

e Contains Thread Manager Options. 

e Available now for MPW, CodeWarrior, Symantec Project 
Manager, PowerPC, Ad, and A4. 


Our Price $299 (spowrap) 


Math by dtF Americas 





e True relational database system for Apple Macintosh computers. 


e Provides a powerful choice for developers who want to create 


database centered applications with no performance trade-offs. 


e Features SQL, full transaction control, error recovery, single 
user, client server architecture and multi-platform support 
including DOS, Windows, OS/2 and UNIX. 

e The C/C++ API is identical and fully portable across all 
supported platforms. 


-Spyer 

by InCider 

_ @ Easy to use tool that records all actions (including mouse 
movement) you perform on a Macintosh computer and then 
replays them at your preferred speed. 

® Recorded data can be saved in files for future use. 

e Works as a background process with any Macintosh appli- 
cation and is triggered by user defined Hot Keys. 

e Enables the “Continuous Redo” utility and is especially use- 
ful for software testing and demonstration. 


Our price $39 (SSPY) 








PictureCDEF 1.3 
by Paradigm Software 


e Professional-level CDEF for creating custom graphical buttons 


(8-64 pixels) — used in products by Adobe, ProVue, STF 

Technologies and others! 

e Multi-monitor and bit-depth sensitive. 

e The button graphic (cicn, ResEdit) can be changed at runtime 
and even animated with a call-back routine. 

e Create distinct buttons in seven variations: MultiState, 
PushButton, FlexiButton, ToggleButton, ChkButton, 
PushPictButton and TogglePictButton. 

e Manual, sample code and MacApp 3.0 support included. 


Full source code: $95 (SPCDEF) 


e Third-party vendors supporting dtF will be able to offer a 
variety of advanced features and benefits to their customers 
royalty free. 

e Tools are included for importing, exporting, creating and 
managing databases and users. 

e Supported development environments include: Symantec, 
MPW, Metrowerks and more. Mac/SDK 


List $695 Our Price $679 (SDTF) 


Speliswell Plus 2.0.4 


by Working Software 
e Award-winning, comprehensive, practical spelling checker that 


works in batch mode or within applications that incorporate the 


Apple Events Word Services protocol (e.g., Eudora, 
WordPerfect, Communicate!, and InfoDepot). 

e Checks for spelling errors as well as common typos like capi- 
talization errors, spaces before punctuation, double word 
errors, abbreviation errors, a/an before vowel/consonant, etc. 

e MacTech orders include developer kit with Writeswell Jr., a 
sample AppleEvents Word Services word-processor and its 
source code. 

e Available for OEM Sales. 


Our price $74.95 (SSPELL) 


Web site: htto://www.devdepot.com @ E-mail: orders@devdepot.com 
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B-Tree HELPER 2.2 
by Magreeable Software 


e Inexpensive database engine for Macintosh programmers 
in C source code. 

e Uses contiguous fixed length blocks. 

e Expands the file as necessary and contracts files when 
possible. 

e Inserts and deletes keys in one or more B-Trees. 

e Finds keys equal to, less than, or greater than a given 
value in a few hundredths of a second. 

e Finds lists of records whose keys are equal to, less than, 
or greater than a given value or are in a range of values. 


Our Price $150 (spTrEe) 








Step-Up Installer Pack ScriptGen Pro 
by StepUp Software by StepUp Software 
e Package of several Installer “atoms” that let developers e Installer script generator which requires no programming 
incorporate graphics, sounds, file compression and cus- or knowledge of Rez. 
tom folder icons into installation scripts. e Supports StepUp’s InstallerPack, Stufflt decompression, 
e Compression formats supported are Compact Pro & Compact Pro 
Diamond. decompression, custom packages, splash screens, net- 
e Each atom also available separately. work installs, and resource installation. 
¢ Compression requires additional licensing. Our price $169 (SSCRPTGEN) 
Our price $219 (siNsTALL) 





TestTrack-Bug Tracking the AppMaker 


Macintosh Way by Bowers Development 
by Seapine Software, Inc. ¢ Develop the user interface for a Macintosh application 


using the original interface builder. 

e Just point and click to design your application. 

e Creates resources and generates excellent source code. 

e Supports most development environments including 
Metrowerks, Symantec, or MPW; 
C, C++, or Pascal; procedural or object-oriented, using 
PowerPlant, TCL, or MacApp. 

e The generated code uses the Universal Headers to provide 
PowerMac compatibility. 

e Great tool for beginners to learn object-oriented and 


e Tracks bugs, feature requests, test configurations, 
users, and more. 

e Includes notifications, security, a powerful filter 
mechanism, and multiple reports. 

e Links your testers, engineers, documentations staff, 
and project managers together to ensure all bugs are 
identified, fixed, and documented. 

e Eliminates the need to build custom bug tracking 
solutions using general purpose database tools. 


e Supports single- and multi-user bug databases (addi- Macintosh Toolbox programming techniques. 


tional licenses required to use multi-user features). e Includes one-year subscription on CD and hardcopy 
Our price $129 err) scien 


List $299 Our Price $199 (sappmake) 
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3D Game Machine 

AdLib 

Animation Class Library 
CLImate 

CMaster 

CometPage 

CometSite 

CometPage/Site Bundle 
DataScript 

ICONIX PowerTools-10 Pack 
ICONIX PowerTools-6 Pack 
ICONIX PowerTools-8 Pack 
ICONIX PowerTools-AdaFlow 
ICONIX PowerTools-ASCll Bridge 
ICONIX PowerTools-CoCoPro 
ICONIX PowerTools-DataModeler 
ICONIX PowerTools-FastTask 
ICONIX PowerTools-FreeFlow 
ICONIX PowerTools-Object Modeler 
ICONIX PowerTools-PowerPDL 
ICONIX PowerTools-QuickChart 
ICONIX PowerTools-SmartChart 
ICONIX Training & Consulting 
IMSL Math and Stat F77 
Info-Mac X 

LJ Profiler 

Mac Games Ill 

Mac Source | 

MacA&D Demo 

MacA&D Product 

MacAnalyst Product 

Macintosh Common LISP 4.0 
MacDesigner Product 
MacScholar 

MacScholar Jr. 

MacWireFrame 

MAScript 

More Savvy 

PowerBuilder Desktop for Mac 
PowerMac 2 

PreFab Player 


Professional MachTen for 68k Macs 


Rosanne 

S-Case 

Savvy 

Savvy QuickTime 
StoneTable for 68K 
StoneTable for PowerPC 
Super Savvy 

SuperPlot 

SuperPlot Pro 


Tenon’s NEW! MachTen Code Builder 


Tenon Ported Applications CD 
Top 10 Pick for Macintosh 
V3d/3dPane/SmartPane 
VText 


CODE 
S3DGAME 
SADLIB 

SACL 
SCLIMATE 
SCMASTER 
SCMTPG 
SCMTST 
SCMTPSB 
SWDSCRIPT 
SICPP10 
SICPP6 
SICPP8 
SICADA 
SICASCII 
sICCOCO 
SICDATAMOD 
SICFASTTASK 
SICFREEFL 
SICOBUMOD 
SICPOWER 
SICQUICKCH 
SICSMART 
TICONIX 
SIMSLSTAT — 
SINFOMAC8 
SLUPROF 
SMACGAMES2 
SMACSOURCE 
SMACADD 
SMACADP 
SMACANP 
SMCLISP 
SMACDESP 
SMACSCHOL 
SMACSCHOLJR 
OFRAM 
SMASCRIPT 
SMORSAV 
OPBDFM 
SPOWERMAC2 
SPLAYER 
SPROM10 
SROSANNE 
SSCASE 
SSAWY 
SSAWYQT 
SSTONE68 
SSTONEPPC 
SSSAWY 
SSPLOT 
SSPLOTPRO 
SM10CODEB 
SPORTED 
STOP10PICK 
SQ3 

SVTEXT 


LIST PRICE 


$299.00 
195.00 
250.00 
09.95 
129.95 
149.00 
149.00 
249.00 
249.00 
7,995.00 
0,995.00 
6,995.00 
1,495.00 
1,495.00 
1,495.00 
1,495.00 
1,495.00 
1,495.00 
1,495.00 
1,495.00 
1,495.00 
1,495.00 
3,000.00 
495.00 
39.95 
295.00 
29.95 
29,99 
149.00 
2,995.00 
995.00 
725.00 
995.00 
29,99 
29.95 
299.00 
199.00 
450.00 
295.00 
29.95 
95.00 
695.00 
095.00 
495.00 
290.00 
290.00 
175.00 
175.00 
700.00 
195.00 
349.00 


Limited Offer 


90.00 
49.95 
192.00 
350.00 


Here are more products. For full product descriptions please see our Web 
/ site, or feel free to call, fax, or E-mail us. 


OUR PRICE 


$299.00 
195.00 
250.00 
59.95 
129.95 
149.00 
149.00 
249.00 
229.99 
7,845.00 
5,945.00 
6,945.00 
1,395.00 
1,395.00 
1,395.00 
1,395.00 
1,395.00 
1,395.00 
1,395.00 
1,395.00 
1,395.00 
1,395.00 
2,945.00 
495.00 
35.95 
295.00 
26.95 
26.95 
75.00 
1,995.00 
945.00 
725.00 
945.00 
26.95 
26.95 
75.00 
195.00 
445.00 
295.00 
26.95 
95.00 
695.00 
595.00 
395.00 
245.00 
245.00 
175.00 
175.00 
695.00 
145.00 
349.00 
99.00 
49.95 
44.95 
192.00 
350.00 


Web site: httpo://www.devdepot.com ® E-mail: orders@devdepot.com 
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Inside Macintosh: CD-ROM 


by Apple Computer, Inc. 

e More than 25 volumes in electronic form. 
e Includes: QuickDraw™ GX Library, Macintosh Human Interface 
Guidelines, PowerPC System Software, Macintosh Toolbox Essentials 

and More Macintosh Toolbox, QuickTime and QuickTime Components. 
e Access over 16,000 pages of information with Hypertext linking and 
extensive cross referencing. 


List $99.95 Our Price $89.95 imo) 
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eee §~PRODUCT 
Inside Macintosh: AOCE Applications Interface 
Inside Macintosh: AOCE Service Module 
Inside Macintosh: Devices 
Inside Macintosh: Files 
Inside Macintosh: Imaging with QuickDraw 
Inside Macintosh: Interapplication Communications 
Inside Macintosh: Macintosh Toolbox Essentials 
Inside Macintosh: Memory 
Inside Macintosh: More Macintosh Toolbox 
Inside Macintosh: Networking 
Inside Macintosh: Operating System Utilities 
Inside Macintosh: Overview 
Inside Macintosh: PowerPC Numerics 
Inside Macintosh: PowerPC System Software 
Inside Macintosh: Processes 
Inside Macintosh: QuickDraw GX Environ. & Utilities 
Inside Macintosh: QuickDraw GX Graphics 
Inside Macintosh: QuickDraw GX Objects 
Inside Macintosh: QuickDraw GX Printing 
Inside Macintosh: QuickDraw GX Printing Extensions 
Inside Macintosh: QuickDraw GX Prog. Overview 
Inside Macintosh: QuickDraw GX Typography 
Inside Macintosh: QuickTime 
Inside Macintosh: QuickTime Components 
Inside Macintosh: Sound 
Inside Macintosh: Text 
Inside Macintosh: X-Reference 


1-800-MACDEV-1 © Outside U.S. & Canada: 805-494-9797 © Fax: 805-494-9798 


CODE 
BIMAOCE 
BIMAOCES 
BIMDEV 
BIMFIL 
BIMIMAG 
BIMIAPP 
BIMTBOX 
BIMMEM 
BIMMAC 
BIMNET 
BIMOPSU 
BIMOVER 
BIMPPCNUM 
BIMPPCSYS 
BIMPROC 
BIMGXENV 
BIMGXGR 
BIMGXOBJ 
BIMGXPRNT 
BIMGXEXT 
BIMGXOV 
BIMGXTYP 
BIMQT 
BIMQTCOM 
BIMSOUND 
BIMTEXT 
BIMXREF 


e3.00 
20.90 
29.99 
32.99 
36.95 
39.95 
24.95 
34.95 
PACS 
28.99 
24.95 
28.95 
24.95 
22.90 
31.90 
Si ince 
31.95 
fas 
29,95 
24.95 
Zo 
23,20 
34.95 
29.99 
39.95 
19.95 


Va 
There _ _ Here are all of the Inside Macintosh products — half off! For full product 
S - descriptions please see our Web site, or feel free to call, fax, or E-mail us. 


LIST PRICE OUR PRICE 
$44.95 


$21.99 
14.50 
14.50 
14.50 
15.99 
17.99 
17.45 
11.99 
16.99 
14.50 
13.99 
11.99 
13.99 
11.45 
10.99 
15.50 
15.50 
15.50 
14.50 
14.99 
11.99 
14.50 
14.50 
15.95 
14.50 
19.50 
9.50 





| http:/www.devdepot.com 
ye p QT E-mail: orders@devdepot.com 
3 4 | U.S./Canada: 800-MACDEV-1 (800-622-3381) 
Outside U.S./Canada 805-494-9797 
: , od ™ Fax: 805-494-9798 


ORDER FORM 


Please fill out as completely as possible to avoid delays in processing your order. 


Name 





Company 





Address 





City State/Province 





Zip/Postal Code Country 


Home Phone Business Phone 





E-Mail Address Fax 





[]Cash (1 Check/Money Order (VISA (MasterCard [i American Express Expiration Date 


Card # Signature 





ORDERING INSTRUCTIONS: Itemize the products you want below. Fill in the Order Total, Sales/Use Tax (for California residents only), and 
Subtotal. Shipping & Handling charges will be added upon processing. All orders will be shipped via most economical method (e.g., UPS 
Ground), unless you state otherwise. Remember to fill out your address and payment information above. 


ITEM DESCRIPTION QUANTITY UNIT PRICE TOTAL 





If you are ordering a subscription to MacTech™ Magazine, are Order Total 
you a new subscriber, or are you renewing your subscription? Sales/Use Tax (CA residents only)* 
SUBTOTAL 


_] New Subscription 


[| Renewal 
FOR OFFICE USE ONLY 


*Magazine subscriptions are non-taxable Shipping & Handling 


TOTAL 


























Fold Here First 


Fold Here (Last) and Tape Closed (not staple) 


BUSINESS REPLY MAIL 


FIRST CLASS MAIL PERMIT NO. 264 THOUSAND OAKS, CA 





POSTAGE WILL BE PAID BY ADDRESSEE 


XPLAIN CORPORATION 
PO BOX 5200 
WESTLAKE VILLAGE CA 91359-9864 














NO POSTAGE 
NECESSARY 


IF MAILED 
IN THE 
UNITED STATES 


Programmer’s Toolbox Assistant CD-ROM 
Instant electronic access to Inside Macintosh essentials. 
by Addison-Wesley Publishing 


e Get quick access to reference pages for over 4,000 Toolbox calls in 
your system software from their development environment. 

e Essential information for Macintosh software developers. 

e Hypertext links allow programmers to view related topics easily. 

e The ultimate electronic reference tool for Macintosh programmers. 


List $99.95 Our Price POY.YO (STBASST) 
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AppleScript Applications: Building 
Applications with FaceSpan and 


AppleScript 

by John Schettino Affiliation & Liz O’Hara 

e Build complete AppleScript applications using FaceSpan, a user 
interface development too! that makes AppleScript applications 
truly “Mac-Like”. Uses a step-by step approach to demonstrate 
techniques for building applications through illustrations and 
samples. Provides Graphical User Interface (GUI) design tips 
and practical approaches for implementation. 

e Contains one CD-Rom with AppleScript 1.1, a demonstrations 
version of FaceSpan 2.1, source code for all example applications 





numerous AppleScript shareware and demonstrations programs. The Elements of E-Mail Style 
e Contains a section on debugging AppleScript applications using by Brent Heslop and David Angell 
Facespan. e Write solid, effective E-Mail and 
List $34.95 Our Price (BAPSCAP) avoid common pitfalls. 
List $14.95 Our Price (BEMAIL) 


t 


Hooked on Java 
by Arthur Van Hoff, Sami Shaio, and Orca Starbuck 


e Written by the Java development team at Sun Microsystems, Inc. 

e An introduction to using applets, for Web administrators, designers, 
and developers. 

e Demonstrates how to use applets in your own pages. 

e Includes a concise introduction 
to the Java language, and a CD with tools. 


List $29.95 Our Price $26.99 (BHJAVA) 
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Java in a Nutshell 
by David Flanagan 


e A complete quick reference guide to Java, the hot new programming 
language from SunMicrosystems. 

e Contains descriptions of all of the classes in the Java 1.0 API, with a 
definitive listing of all methods and variables. 

e Also contains an accelerated introduction to Java for C and C++ 
programmers who want to learn the language fast. 


List $14.95 Our price Di. ) (BJAVANUT) 
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Web site: htto://www.devdepot.com ¢ E-mail: orders®@devdepot.com 





_ with Timothy Webster and Tim Ritchey Lee 
Java e Add interactivity and multimedia to Web e Allows non-program- Serre aeatincen 
: FoR Macinrost pages! mers to take advantage J AVA SCRIPT 
| e A step-by-step guide to make your Web of the power of “FOR MACINTOSH 
iwt * 


oe Planning and 
_ —. Managing Websites 


sosenarpervoeorme 
tear manttt 


i ee 
ee hades o spacial wees er cWehSTAR and a cll 


=n : by Jon Weiderspan and Chuck Shotton 


e The definitive guide to setting up and 
running a Web site on the Macintosh. 

e Learn everything you need to know about 
using WebSTAR, the best known HTTP server 
software and its shareware 
predecessor MacHT TP. 

e Write CGI applications for your server — in 
AppleScript and in C. 

e CD includes a special version of 
WebSTAR, plus tons of useful software. 


List $39.95 Our Price (BPLANWEB) 






Teach Yourself Java for 
Macintosh in 21 Days 


by Laura Lemay and Charles L. Perkins 





site come alive. 







JavaScript for 


the Macintosh 
by Matt Shobe 
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Netscape Navigator. 
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ag e Learn the basics of programming Java applets and the con- e Expand the capabilities of your Web page, 
a 
ha cepts behind the Java language. without having to understand C or C++. 
Z,\ e Includes CD-ROM with a limited version of Roaster, the first e CD-ROM contains “Wizlets” that allows you 
es | commercial, integrated applet development environment for to easily create your own JavaScripts 
Java for the Macintosh! e Takes you step-by-step through programming 
List $40 Our price (BUAVAMAC) cross-platform Javascripts 
e Details how to create JavaScripts for 
\ Javascript-aware Web browsers 
List $45 Our price (BUAVASCRPTJ) 
i clud 
: Wa e 
Mac OS 8 Revealed 
| by Tony Francis 
i e The first authoritative look at this exciting new operating system. 


e A must for Mac developers who want to make their software 
compatible with Mac OS 8. 

e Essential for system administrators who plan to upgrade their system. 

e Included CD-ROM contains demos of new Mac OS 8 features. 


List: $34.95 Our Price: (BMACOSS8R) 
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Learn C on The Macintosh Second Edition 
By Dave Mark 


e New revised edition. 

e Easy-to-understand — everything you need to start programming! 

e Updated and enhanced exercises that lead you step by step. You'll learn function, vari- 
ables, pointers datatypes, data structures, file input and output and more! 

e Includes CD-ROM with Metrowerks CodeWarrior™ Lite — the hottest Macintosh program- 
ming environment (including a PowerPC version). 


List $34.95 Our Price $31.45 (BLEARNC2) 














odeWarrior Software Development Using PowerPlant 
y Jan L. Harrington 

C++ programmers will learn to develop object-oriented software applications for the 
Mac and Power Mac using the PowerPlant environment and the classes that support it. 
e Covers CodeWarrior 8. © Included CD-ROM contains source code for all the pro- 
gramming examples in the book and Metrowerks CodeWarrior Lite. 


List Price: $34.95 Our Price: 9 (BCWSWDEV) 





esigning Animation for the Web 
y Hayden Development Team 


e Provides technical information and design advice for creating animation on the web 

e Expert tips show which technology to use for specific needs: GIF animation, Shockwave, Java and more. 
¢ Covers bandwidth considerations and the integration of animations into overall site design. 

e Step-by-step instructions. 

e CD-ROM includes tools, scripts, and examples for creating animations. 


List $40 Our Price $30 (BDAFTW) 
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Perl Quick Reference 
by Michael 0. Foghlu 


e Commands are sorted by task, class packet, platform or 
hardware compatability all in alphabetical order 


CGI By Example 
by Jeffrey Dwight 


e CD-ROM contains all the code and tools used in the 
book, and additional tools and examples, as well as 


NN 


| 
Ss 


related chapters from Special Edition Using CGI and 
Special Edition JavaScript 

e Includes end of the chapter review questions and 
exercises to reinforce the learning process 

© Covers basic CGI applications, as well as advanced 
topics like server administration issues and database 
connectivity 


List $34.99 Our Price $31.45 (ssciBp 








e Includes jump tables to guide reader to specific pages in 
the reference 

e Designed in a larger trim size than traditional Quick 
References-and with a lay-flat binding 


List $19.99 Our Price « »JJ (BPERLREF) 


Optimizing PowerPC Code: 
Programming the PowerPC in 
Assembly Language 

by Gary Kacmarcik 


e Take full advantage of the potential of the PowerPC by mas- 
tering the Assembly Language techniques. 
e Learn to produce faster more robust software! 


List $39.95 Our Price POV (BOPTPPC) 


Web site: htto://www.devdepot.com ¢ E-mail: orders@devdepot.com 
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Macintosh € Programming Primer Volume | 
second Edition, Inside the Toolbox Using THINK C by Dave Mark and Cartwright Reed 


e Updated new edition of the Macintosh programming best seller. 

e System 7, new versions of THINK C and ResEdit. 

e Learn how to use the resources, Macintosh Toolbox and interface to create stand-alone application: 
e 6/2 pages. 


List $26.95 Our Price (BCPRIM1) 


Macintosh € Programming Primer Volume Il 
Mastering the Toolbox Using THINK C by Dave Mark 


e Covers advanced topics such as: Color QuickDraw, THINK Class Library, TextEdit, and the 
Memory Manager: 528 pgs. 


List $26.95 Our Price (BCPRIM2) 


Learn C++ on the Macintosh 
by Dave Mark 


e Basic syntax of C++ and object programming. 

e Learn how to write, edit, and compile your first C++ programs. 

e Features key C++ concepts such as derived classes, operator overloading, iostream functions and more. 

e Includes a special version of Symantec C++ for Macintosh. Book/disk package with 3.5" 800K Macintosh 
disk. 400 pages. 


List $36.95 Our Price (BLRNCPP) 
SEE RELATED CATEGORY: Dev. Environments 






Macintosh Pascal Programming Primer Volume | 
Inside the Toolbox Using THINK Pascal 
by Dave Mark and Cartwright Reed 


This tutorial shows programmers new to the Macintosh how to use the Toolbox 
resources, and the Macintosh interface to create stand-alone applications with 
symantec’s THINK Pascal. 544 pages. 


List $26.95 Our Price $24.25 (Bpascpr) 
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Power Macintosh Programming Starter Kit 
by Tom Thompson 


e Enter the world of the PowerPC chips. 
e Get the scoop on the microprocessors, the RISC architecture, and how to write 
native code and emulation operations to create software for the Macintosh PowerPC. 
“y e CD-ROM includes a unique compiler for writing code easily. 
Ps <- PROGRAMMING 8 : List $39.95 Our Price (BPPCSTART) 
ag an Asli KIT). | 
CD athe eee 298) SEE RELATED CATEGORY: Dev. Environments 
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Macintosh Programming Secrets 2nd edition 
By Scott Knaster and Keith Rollin 


e Macintosh Programming Secrets is divided in two parts. 

Order Toll-free Part 1: “Concepts and Ideas”, discusses the evolution of the Macintosh and the standards, 

Wa customs, and software that shape the system as well as the Macintosh user interface. 
Part 2: “Technical Adventures”, presents the skeleton of an application, and then builds upon 
that framework to describe how to: ¢ Create fancy dialogue boxes © Utilize the new 32 bit 
QuickDraw developments ¢ Track the mouse with “marching ants” ¢ Manage multiple windows 
with the Window manager ¢ Copy files within a program e Install the worlds 
strangest spinning cursor. 


List $31.95 Our Price (BPSECRET) 
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yberdog Programmers Kit 
Apple Computer, Inc. 


Apple’s official reference. 
A must for developers who want to make customizable Internet access 
available to all Mac users. 

Included CD-ROM contains all the tools needed to create Cyberdog-aware 
components. 


List: $39.95 Our Price: $34.95 (ecyBeRDOG) 









A Fragment of Your Imagination 
by Joe Zobkiw 


e Packed with useful code fragments for the Macintosh and Power Macintosh. 

e Hard to find information about techniques used to structure 
en ee and build fat, safe fat, and accelerated code resources. 

oles 8 Bower Macintosh’ e All code is reusable and is provided on the disc, along with 

—— <. Metrowerks 

Code Warrior Lite. Book/CD-ROM, 528 pages. 


List $39.95 Our Price $35.96 (FRAG) 








Joe Zobkiw 





Programming with AppleTalk 
by Michael Pierce 


e Programming with AppleTalk is the hands-on guide to understand- 
ing and working with AppleTalk. Topics covered include: 


. e How to create applications and system extensions that run with 
ava Language API SuperBible AppleTalk 


yy Daniel Groner, Todd Sundtsed, 


: e AppleTalk protocols and the protocol stack, transport media, the 
‘asey Hopson, Harish Prabandham 


Preferred AppleTalk Intefrace, and the storage management. 


Covers Java 1.1 e Numerous working code examples walk you through using RDEV, 
Hundreds of concrete source code examples provided INIT, NBP, ATP, and ADSP. You will also learn the use of: 

Sample projects introduced and assembled in each chapter Synchronous, and asynchronous calls, How to avoid heap trag- 
List $59.99 Our price $53.99 @uLas) mentation, And how to configure a Chooser Interface. 


List $24.95 Our Price $22.45 (BPROAT) 


NetObjects Fusion Handbook Infini-D Revealed 

from Hayden Development Team by Brendan Donahoe & Adam Lavine 

e Create Web pages and Sites through design techniques e CD-ROM includes a demo version of Infini-D 
developed by Clement Mok’s design agency. 3.1, files for working through the tutorials, 


e Step-by-step instructions on updating sites with links 
and navigational controls automatically. 

e Outlines the comprehensive steps to delivering an auto- 
mated, turnkey Web publishing solution. 

e CD-ROM contains a 45 day time-limited version of 
NetObjects Fusion. 


List $50 Our Price $45 (BNETOFH) 


and a gallery of spectacular 3D images 

e Shows how to use the new animation fea- 
tures to bring images to life 

Details Infini-D’s new and improved color- 
coded interface 


List $45 Our price $40.50 (sinroreV 





Web site: htto://www.devdepot.com ® E-mail: orders@devdepot.com 











AppleScript Finder Guide, 


English Dialect 
by Apple Computer, Inc. 


AppleScript Language Guide e Provides definitions for Finder object classes 
by Apple Computer, Inc. and commands. 
e A complete reference for anyone using AppleScript to modify existing e Write, record, or run scripts that trigger the 
scripts or to write new ones. same desktop actions that you trigger using the 
e Contains useful information for programmers who are working on keyboard and mouse. 
scriptable applications or complex scripts. List $19.95 Our Price (BAFG) 
e Features detailed definitions of AppleScript terminology and syntax in SEE RELATED CATEGORY: Scripting 
the following categories: Value classes, commands, objects and ref- 
erences to objects, expressions, control statements, handlers, and 
“ie objects. ain Pe en AppleScript Scripting 
e Includes many sample scripts, discusses advanced topics such as =a: p 
writing command handlers for script applications, the scope of script Additions Guide 
variables and properties declared at different levels in a script, and by Apple Computer, Inc. 
inheritance and delegation among script objects. e Use the standard scripting additions commands. 
List $29.95 Our Price (BALG) e Write scripting additions. 


SEE RELATED CATEGORY: Scripting List $18.95 Our Price (BSCRADD) 
SEE RELATED CATEGORY: Scripting 


| 
Ss 
a 


Ap , SCRIPT Danny Goodman’s AppleScript Handbook 
: " Second Edition by Danny Goodman 
— e Customize and extend the capabilities of any Macintosh computer — no 
programming experience needed! 
e Learn to use scripts to enhance the Macintosh environment, automate many 
processes, link data between applications, and much more. 
e All-new examples showing how to integrate AppleScript with the Finder, 
| nnn spreadsheets, desktop publishing programs, graphics applications, databases, 
nevetrdenh oe, a ee telecommunications programs, utilities, and HyperCard. 
apa . same e Includes 3%" disk with over $100 worth of software, including 
Applescript 1.1, valuable utilities, and powerful, ready-to-use scripts. 


List $39 Our Price 30 (BDGASHB) 
SEE RELATED CATEGORY: Scripting, Tools, Libs & Utilities 
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Applied Mac Scripting 


/ F ae 2 : 9 
a 5 "3 eS : : € Se eng eeeraeae eeeeraaT eT ai il oii ace Si eeteeoeaeiaaiage ee se Ei EEE 
Bake a a ae SNe nh eg SERS gta is cisions emmanuelle =p eee aac sp Sudce os cag oases RSLS SR ey Satine Sate 2 : seinen ~ 


BOOKS AND BRI 


\ by Tom Trinko e Harness the capabilities of a wide variety of Macintosh 
e Learn to design and develop powerful scripts. applications into the integrated productivity tools. This 
e Covers AppleScript™, Frontier, QuicKeys, Tempo Il, nShell, includes such things as the newspaper script which com- 
Facespan Application Builder, Scripting PlainTalk and System bines the power of SITcomm, MacWrite Pro, and FileMaker 
\ 75, Pro, or QuarkXPress. 
| e Hands on tutorial shows you how to automate your List $34.95 Our Price (BAPPLIED) 
Macintosh activities by learning how to use the AppleScript SEE RELATED CATEGORY: Scripting 


and Frontier scripting environments. 


1-800-MACDEV-1 ¢ Outside U.S. & Canada: 805-494-9797 © Fax: 805-494-9798 



















PowerPC 


Programmer’s 


owerPC Programmer’s Toolkit 
y Tom Thompson 


Toolkit 





CD-ROM includes a special version of Metrowerks CodeWarrior 7.0 and sample code from 

the book ieuiee ex ths 
Details how to write PowerPC applications in native code for blazing speed patent 
Written by an Apple Insider 

List $45 Our Price (SPPCPT) 


astering Netscape 2.0 for Macintosh, 2nd Ed. Network Frontiers Bundle 


Grea Hold by AP PROFESSIONAL 
aReee (Includes 3 books: Complete Guide to 
CD-ROM includes Netscape Plug-Ins and helper applications i AeIE toes Wittacernant, Deslating AGpIeTaIk 


Uncovers hidden features of the program and how to best utilize them 
Web page for the book includes cool utilities and updated information 


List $40 Our Price (SMASNET4) 


Network Architectures, Managing AppleShare 
and Workgroup Servers) 





e Apple Certified 

e Each bundle includes the first 3 books 
that correspond to the Apple 

e Certified Server Engineer (ACSE) program 


List $89.95 Our Price (BNETFB) 


MARK MULLIN 


ject Oriented 
phiec Design 


With Examples in 6+ + 






Object Oriented Program Design 

by Mark Mullin 

e A concise guide to the essential concepts and techniques of OOP design 

e Clarifies the key concepts of object oriented programming such as objects, classes, 
entities, hierarchies, and inheritance 

e Uses typical database application to illustrate each OOP topic, to give the programmer a 
familiar point of reference 


List $22.95 Our Price | (BOOPRODES) 


DeBabelizer: The 
Authorized Edition 


by Hayden Development Team 


intranet Web Development: Enterprise Alternatives to 
Client/Server Computing by Hayden Development Team 
e Learn why traditional client/server computing is being replaced by new 


WWW technologies. e Teaches effective ways to utilize DeBabelizer to 
e Discusses WWW application development with the Microsoft Visual improve graphic’s quality and speed. | 
Script enterprise application developer in mind. e Offers techniques for using SuperPallette to opti- 


e Learn techniques for the conversion of existing Visual Basic, C++ and mize Images. 
PowerBuilder Applications to the new WWW platform. e Provides extensive visual examples to illustrate key 
List $49.99 Our Price 2 (BINTWD) ogy techniques in all areas of graphics pro- 

e CD-ROM includes the Lite version as well as 
Photoshop plug-ins. 
List $45 Our Price (BDEBTAE) 

Tog on Software Design 

by Bruce “Tog” Tognazzini 

Respected industry futurist, Tog, presents his vision of our technological 

future, detailing the steps computer professionals need to take to deliv- 

er new technologies that will profit the industry and benefit society in 

general. Contains Tog’s insights on a wide range of topics from quality 

management to the meaning of standards, and responses to queries 

supplied by designers and developers. 


List $29.95 Our Price $26.95 (BTo«) 





Web site: htto://www.devdepot.com @ E-mail: orders@devdepot.com 
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3D Graphies Prog 


3D Graphics Programming ‘v. 


Using QuickDraw 3D 

by Apple Computer, Inc. orro® 

e Incorporate spectacular 3D graphics into your applications. 

e Explore QuickDraw 3D, a revolutionary graphics extension to 
the Mac OS for Power Macintoshes. 

e CD contains the complete QuickDraw 3D system itself and a 
complete database of the QuickDraw 3D API, allowing you 
instant access to the hundreds of graphics calls via a fast 
viewing engine. Book/CD-ROM, 640 pages. 


List $39.95 Our Price (B3DGRAP) 








Sex, Lies and Video Games 


yh by Bill Hensler 

?) APUG 
Pe e A learn-by-example tutorial on the ins and outs a) TAS 
po of Mac arcade-style game programming in C. -— We t 


e Features game theory, sprite animation, sound, eS 


and interaction techniques. 
e A must-read for serious programmer’s and 
hobbyists alike. 


List 34.95 Our Price (BSEX) 
SEE RELATED CATEGORY: Tools, Libs & Utilities 
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rw Tricks of The Mac Game 3D Graphics-Tips, 
- Programming Gurus Tricks, & Techniques 
~~ by McCornack, Ragnemalm, Celestin, et al. by David Kalwick 
f, e For beginning to expert game programmers e Written from a user’s point-of-view, this 
jae \ e Complete overview of all the necessary com- book covers all the important 3D techniqu 
pal ponents of game programming on the including lighting, textures, animation, ca 
ae Macintosh. era angles, and perspectives. 
pam \ i= ° Packed with valuable tools, utilities, sample e Through easy-to-understand examples yo 
Fo | : il code, CodeWarrior™ Lite and game demos. learn how to create high-quality 3D graph 
_ e QuickDraw 3D and Power Mac optimization ICS. 
and inside info on how Glypha Ill was created. e Includes a Windows/Macintosh CD-ROM 
\ e Hundreds of tried-and-true tricks, tips, and featuring tutorials, 3D examples from the 
' i insider secrets from well-known Mac game book, and more. 
programming experts List 34.95 Our Price (B3DG 
List $50 Our Price (BTRICKS) 


Black Art of Macintosh Game Programming 
by Kevin Tieskoetter Black Art of 


e Develop your own 3D games in C on the Mac. MACINTOSH = 


e Includes CD with project files for both Symantec C and Code Warrior 
e Create freeform texture-mapped games and polygon graphics 

e Control dynamic source code-all compatible as native to the Power 
Mac 


e Write directly to the screen, bypassing QuickDraw 
List $39.99 Our price (BBLACK) 
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GRAPHICS GEN 


EDITED BY PAUL S. HECKBERT 


Graphic Gems V See 

Edited by Alan W. Paeth ae 

e Loaded with practical tools for implementing | 
new ideas and techniques, to offer working solu- 
tions to real programming problems. 

e Contains over 40 new gems in ellipses, splines, 
Bezier curves, and ray tracing — displaying the 
most recent and innovative techniques in graphics 
programming. 

e Includes a disk with source code from all five vol- 

ba ~ umes. Available in both IBM and Macintosh ver- 

7 “ sions. CONTENTS: Algebra and Arithmetic. 

Computational Geometry. Modeling and Trans- Advanced Color Imaging 

formation. Curves and Surfaces. Ray Tracing and on the Mac 0S 


Radiosity. Halftoning and Image Processing. 
Utilities. by Apple Computer, Inc. 


List $49.95 Our Price $44.95 (ecemss) e Enhance your software's color capabilities 
with step-by-step instructions. 
e Augment the color support supplied with 


‘ 





AppleGuide Complete QuickDraw, and QuickDraw GX. 
by Apple Computer, Inc. e Use the Pallette Manager to get the best 
e Covers Guide Maker, the software you use to colors on limited displays. 
build and test guide files. e Match colors between screens and 
e Learn about the complete cycle of designing input/output devices (scanners & printers) 
as well as advanced topics such as scripting ¢ CD includes a complete reference intor- 
and coding guide files. Book/CD-ROM, 544 mation in both QuickView and Acrobat 
pages. formats. Plus, a sample application 
List $39.95 Our Price | 96 earico) demonstrating ColorSync programming 
) ee techniques. 
SEE RELATED CATEGORY: Tools, Libs & Utilities . 
List $36.95 Our Price (BADVC)) 





penDoc Programmer’s Cookbook 

Apple Computer, Inc. 

Shows you how to create OpenDoc software components, called parts editors, for the Mac OS Platform. 
Including instructions for setting up the Macintosh Programmers Workshop (IMPW) development 
environment to write OpenDoc software 

Annotated listings of explaining the methods that implement the SamplePart part editor 
Descriptions of other sample part editors created by the OpenDoc engineering team to illustrate 
more advanced features 

Summary descriptions of software utilities provided with OpenDoc for the Mac OS 

An Introduction to the System Object Model (SOM) technology underlying OpenDoc 

List $24.95 Our price Peée40 (BODCOOK) 








iside PowerPlant Manual 
y Metrowerks 


ResEdit Complete, 


Create PowerPlant applications using the ‘}. Second Edition 

CodeWarrior IDE and PowerPlant Constructor. E i t by Peter Alley and Carolyn Strange 

Full descriptions of major PowerPlant classes and Res ul e Customize every aspect of your interface form 
reSOUrces. Comp lete creating screen backgrounds and icons to cus- 


tomizing menus and dialog boxes. 608 pages. 
Book/disk package. 


List $34.95 Our Price (BRESED2) 


Included are the PowerPlant Constructor Manual, 
including View, TextTraits and Custom Types edit- 
ing, and PowerPlant Library Reference, covering 
all classes and functions in PowerPlant. 


Our Price B 2 (BINSPP) 
SEE RELATED CATEGORY: Dev. Environment 





Web site: htto://www.devdepot.com ® E-mail: orders@devdepot.com 
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em O++ Programming with CodeWarrior 
Ls alle by Jan L. Harrington 
é e Beginning OOP for the Macintosh and Power Macintosh and Mac OS 
compatibles. 
e Learn object-oriented programming techniques using C++ as the exam- 
ple language and Metrowerks and CodeWarrior as the example compiler. 
e Enclosed CD contains example code from the book and a full-function 
Metrowerks CodeWarrior 


List $35.95 Our Price $32.35 (BcpPcw) 


OpenDoc Programmer's Guide 

by Apple Computer, Inc. 

e The official reference for the implementation of OpenDoc on the Mac OS. 

e Describes the component software revolution and explains how to develop for it on the Mac OS platform. 

e Accompanying CD-ROM contains a complete reference to the OpenDoc programming interface, and an extensive 
collection of tested, reusable sample code. 


List $44.95 Our Price $40.46 @openvoc) 
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The ResEdit All Night Diner 

by David Ciskowski 

e An idea-filled menu and introduction to the joys of customizing software. 

e Add personality to the Mac by customizing default icons, the text of menus and dialog 
boxes, cursors, pointers and more. 

e Disk features ResEdit, plus lots of sample resources 
List $24.95 Our Price $22.45 (BRESDINE) 
SEE RELATED CATEGORY: Dev. Environments 





C++ Programming with MacApp 


by David Wilson, Larry Rosenstein & Dan Shafer 

e Learn the secrets to unlocking the power of MacApp®, Apple’s development envi- 
ronment for C++ 

e Learn to design complex windows and views using the ViewEdit tool 

e Learn to support multipage text and graphics with only five lines of code 

e Learn to support Undo for menu commands and drawing operations that use the 
mouse. 


List $34.95 Our Price $31.46 (ecppmacap) 
SEE RELATED CATEGORY: Tools, Libs & Utilities 


DAN SHAFER 





Essential OpenDoc Inside CodeWarrior 11 
by Jesse Feiler and Anthony Meadow by Metrowerks 


e Gives an in-depth look at the technical issues of OpenDoc e Includes CodeWarrior IDE User’s Guide. 
e Explores the three core technologies that support it’s e This is the printed version of the 
functionality - SOM, OpenDoc’s storage mechanism, and documentation provided on the CD. 
the Open Scripting Architecture (OSA). e Covers CodeWarrior, the debugger, and 
e Also examines CyberDog, a set of OpenDoc part editors that associated tools. 
provides access to Internet services and offers compelling Our Price $34.95 (BINSCW) 
example of the power of OpenDoc development SEE RELATED CATEGORY: Dev. Environment 
List $39.95 Our price $35.95 (esop) 





1-800-MACDEV-1 © Outside U.S. & Canada: 805-494-9797 © Fax: 805-494-9798 











Metrowerks CodeWarrior Programming 
by Dan Parks Sydow 


e Includes CodeWarrior Lite, and Full Coverage of PowerPlant™. 


e The best information on Metrowerks CodeWarrior, giving full coverage to the Gold Edition. Order Toll-free 
¢ CD includes Code Warrior Lite. EV, 1 
List $39.95 Our Price B3O.2d0 (BCWPROG) (00622-3381 


Visual Programming with Prograph CPX 


by Scott B. Steinman and Kevin G. Carver 

e An introduction to the language and a guide for advanced users, for both 
Macintosh and Windows-based machines. 
List $34 Our Price P9U.OU (BVISPRO) 
SEE RELATED CATEGORY: Dev. Environments 


The Power of Prograph CPX 

by Dan Shafer 

e Master the revolutionary graphical object-oriented programming language. 

e Step by step course through three interrelated projects of increasing complexity. 
e Learn Prograph language, CPX classes and object editors. 

e Includes disk with all code in the book. 


List $49.95 Our Price B1Y.99 (BDANPRO) 





Mastering the THINK Class Library 


by Richard Parker 

e Provides a thorough examination of Symantec’s extensive Class Library and the 
Visual Architect. 

e A complete description of the structure and operation of the TCL includes explanations 
of all code generated by the Visual Architect, any necessary custom code, and the 
operation of this code. 

e Visual Architect tutorials provide you with a step-by-step approach for simplifying the 
development of complex Macintosh applications. 496 pages. 


List $29.95 Our Price DZO. JO (BMASTERTCL) 
SEE RELATED CATEGORY: Dev. Environments 





Danny Goodman’s Apple Guide Starter Kit 

by Danny Goodman and Jeremy Joan Hewes 

e Create your own Apple Guide databases quickly and easily, without having to learn a 
scripting language, write coded files, or use several different files and programs 

e Includes advice and tips on how to design a good Guide, from planning and creation 
through testing, revising, and indexing. Book/disk, 320 pages. 


List $34.95 Our Price $31.40 (BDGAGSK) 





MacsBug Reference & Debugging Guide For MacsBug version 6.2 
by Apple Computer, Inc. iy 


e MacsBug is an assembly-language-level debugging tool 

e Macros, templates, dcmds, and other resources for making debugging easier 
e Macintosh memory management and the operating system as they relate to low level debugging 

e How to display and set memory and process registers, disassemble memory, and set execution breakpoints 

e Discipline, a tool for testing the validity of toolbox parameters, debugging strategies to find & cure common bugs 
e Includes MacsBug 6.2. 


List $34.95 Our Price $31.46 (BBUGREF) 





Web site: htto://www.devdepot.com @ E-mail: orders@devdepot.com 
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Netscape Navigator 3.0 
by Bryan Pfaffenberger 


e Learn the best Web surfing techniques. 

e Quickly find your way to valuable information on the Web. 
e Learn to use the new plug-in tools, including Live3D and Real Audio. 

e Send and receive electronic mail to anyone on the Internet. 

e Utilize the enhanced security features for on-line shopping and ordering. 


List $29.95 Our Price $26.96 (BNETN3) 











Programming For The Newton: Software 
Development using NewtonScript 

by Julie McKeehan and Neil Rhodes. Foreword by Walter R. Smith 
e An indispensable tool for Newton programmers. ¢ Includes disk with 
sample Newton application from the books, as well as demonstration 
version of Newton Toolkit (NTK) — the complete development environ- 
ment for the Newton®. ¢ A Publication of AP Professional May 1994, 
Paperback, 393 pp. 

List $29.95 Our Price $26.95 ePrRocNewn 

SEE RELATED CATEGORY: Dev. Environments 
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on aft Intranet with the Macintosh 





Building and Maintaining 
an Intranet with the Macintosh 
BASIC for the Newton by Tobin Anthony 


by John Schettino & Liz O’Hara e Set up services such as video conferencing, Real 
Audio, message boards, employee scheduling, e-mail, 
WWW, ftp, and many more. 

e Find a simple, cost-effective solution to providing cor- 
porate information to company employees. 

e Learn how to open portions of your intranet site up to 


e Program on Macintosh, Windows-based PC, or on the 
Newton itself. 

e Straight-forward “programming by example” approach 
— you'll be writing Newton programs right away. 

e (Includes 3.5" disk containing Demonstration NS BASIC 


| 
S, 


\ and over fifty example programs. (Newton not included) as internet ee private information safe. 
e Companio - 
List $35.95 Our Price $32.35 (BNEwn aan : sane orice $45 
SEE RELATED CATEGORY: Dev. Environments Disk! ist $50 Our Price (BBAMA|) 
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Netscape Navigator Starter Kit for Macintosh 


by MacMillan 

e Create your own home page in minutes and add hyperlinks to your favorite Web sites 
e Add graphics, audio, and video 

e Download files via FTP 

e Load plug-ins to enable movies, audio, animations, and more 


List $34.99 Our Price $31.49 (BNETNSK) 
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Web Page Scripting Techniques 


by MacMillan 
e Manipulating color effectively 


ig SORE ie SRR Uso eS Ra ck at NRO 0s SY IDEAEE 8 og Thala 


meal 
y YY 
Ld 
ae, 
ile 
iw 
ne 
ni 
iw 
— 
Bar 
iw 
~~ 
aa 
ea 
pare 
> 
Faroe 
of | 
g 
ae 
sit, 
i 
ii. 
ad 
TD ona 
tee | 


e Placing images and using shapes wont 
\ e Using JavaScript functions and objects, plus VBScript functions and objects wed Page 
e Determining users’ browser type and operating system stu Prine reenaiaecs 


List $50 Our Price $45 (BWEBPST) 
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Internet Publishing with Adobe Acrobat 





piece eee 
re acinar w e Optimizing PDF for Web viewing, integrating HTML and PDF, 
, | selecting PDF page dimensions, PDF file evaluation 
Se f = Setting links to PDFs and URLs, PDF forms, Security algorithms, 
: Configuring Web servers for PDF, Embedded PDFs, PDF creation 
techniques. 


List $40 Our Price $36 (BIPWAA) 





Learn Java on the Mac Providing Internet Services 
| by Barry Boone with Dave Mark via the Mac0S 
[LEAR N e Easy-to-follow introduction for beginning by Carl Steadman and Jason Snell 
programmers and Webmasters. e Shows you how to provide Web pages, FTP, Gopher, 
e Takes you through the core concepts of e-mail. and more with the Mac OS. 
ON THE Java. iad | e Includes CD-ROM containing all the Mac server 
AY, EX INTOSH i Includes: Object-oriented techniques, software and utilities you need. 


unique features such as garbage collection, 
and basic programming concepts such as 
working with variables, threads and classes. 
e Learn to apply this knowledge to write original Java applets for Web 
pages. Learn HTML on the Mac ........ 
¢ Includes CD-ROM by Dave Mark and David Lawrence — 
List: $34.95 Our Price: $31 “AD BLJAVA). e Shows you how to use HTML 3.0. i 
e Included CD-ROM contains Macintosh tools to 
design stunning multimedia Web pages. 


List: $29.95 Our Price: $26.95 (BLHTML) 


List: $34.95 Our Price: $31.46 (PROVNEN. 
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_ Here are more products. For full product descriptions please see our 
’ Web site, or feel free to call, fax, or E-mail us. Our prices on books are at 
least 10% off list price. 
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ODUCT CODE PRICE PRODUCT CODE PRICE iw 
velopment Environments Hardware —_ 
leScript Applications: Building Applications w/FaceSpan BAPSCAP $31.45 Apple CD-ROM Handbook BCDHAND 14.36 ee 
c for the Newton - Programming using NS BASIC BNEWT 32.35 Designing Cards & Drivers for the Macintosh BCARD 26.96 ual 
- Programming with CodeWarrior BCPPCW 32.35 LaserWriter Reference BLASERREF 17.96 ) Pa 
- Programming with MacApp BCPPMACAP 31.46 PCI System Architecture 3rd Edition BPCISYS 31.46 

++ SDK User's Guide BCPPUSER 29.00 PowerPC System Architecture BPPCARCH 31.46 ate, 
eWarrior Inside PowerPlant BINSPP 34.95 po 
eWarrior Software Development using PowerPlant BCWSWDEV 31.45 Internet Related Sf, 
Shafer Presents the Power of Prograph CPX BDANPRO 19.95 1994 Internet White Pages BO4WHITE 26.95 | > 
TRAN SDK User’s Guide BFORTUSER 34.95 Active Java BACTJAVA 23.36 4 
le CodeWarrior Book BINSCW 34.95 America Online for Dummies BAOLDUM 17.95 

Resort Programmers Edition BLSTRSRT 74.95 CGI By Example BCGIBE 31.45 6 
nC on the Macintosh, 2nd Edition BLEARNC2 31.45 Computer Privacy Handbook BPRIV 22.45 A 
tering the Think Class Library BMASTERTCL 26.95 E-Mail Essentials BEMAILE 22.45 no 
rowerks CodeWarrior Programming BCWPROG 35.95 Elements of E-Mail Style BEMAIL 13.45 J Be 
senting Magic Cap BPRESMAGIC 15.25 Hooked on Java BHJAVA 26.95 aay 
jramming for the Newton Using NewtonScript BPROGNEWT 26.95 Instant Internet Guide BINSTANT 13.45 oe. 
| World Apple Guide BREALWLD 35.95 Internet Book BTHENET 22.50 ‘ae 
antec C++ Programming BSYMCPP 39.50 Internet for Dummies 2nd Edition BNETDUM2 17.99 (aa 
yent’s Guide to Designing Programs BTALIGENT 17.55 Internet for Dummies Quick Reference BDUMQCK 8.05 / = 
al Programming with Prograph BVISPRO 30.60 Internet for Macs for Dummies BNETDUM 17.95 

less For The Newton BWIRELESS 31.45 Internet for Macs for Dummies Bestseller Edition BIFMFDBE 35.99 
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Internet Power Tools 

Internet Publishing with Adobe Acrobat 
Internet Secrets 

Internet, The, Deluxe Edition 

Intranet Web Dev.: Enterprise Alternatives to Client/Server 
Java Essentials for C/C++ Programmers 
Java in a Nutshell 

Java Language API SuperBible 
JavaScript for Macintosh 

Learn HTML on the Macintosh 

Learn Java on the Macintosh 

Mastering Netscape 4.0 for Macintosh, Second Edition 
More Internet for Dummies Starter Kit 
Mosaic for Dummies 

Net Chat 

NetObjects Fusion Handbook 

Netscape Navigator 

Netscape Navigator Starter Kit 

Perl Quick Reference 

Planning and Managing Web sites 
Providing Internet Services 

Publish it on the Web 

TCP/IP Vol 1-Vol 2 Bundle 

Teach Yourself Java in 21 days 
Underground Guide to Telecommuting 
Web Head Mac Guide 

Web Page Scripting Techniques 

Web Weaving 

Webmaster Macintosh 


Scripting and Solutions 

AppleScript Applications: Building Apps with FaceSpan 
Applied Macintosh Scripting 

Complete AppleScript Handbook 

Complete HyperCard 2.2 Handbook 
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Behind every good Mac app... 


Every job requires the proper tool. When it 
comes to crafting good code, BBEdit 4.0 is 
the Swiss Army Chainsaw of text editors. 


"If you have to spend time with text 
on the Mac, you should use BBedit." 


-- MacWeek, September 30, 1996 


¢ Compare source files and 
apply differences 


¢ Open From and Save To FTP 
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¢ Search and replace multiple files 
using Grep 


ne 


e Navigate source files with integrated 
PopupFuncs™ technology 


¢ Browse project documents 





PL8E2e Marathon object .h FeeeeeeeeeTeeae PISS SES 
N Last Saved: 11/6/96 at 6:10:26 PM 
mm Power HD ‘Desktop Folder Marathon Infinity 
struct object.location 


struct world.point3d p; 
short pol ygon..|ndex; 


angle yaw, pitch; 


) word flags; 


struct object.data /* 32 bytes */ 


/* thage fields are in the order of a world.locationad a«trusture, but are migeing the pitch 
ond vatacity fielde */ 


worldupoint3d location; : ae 

short polygon; : 

angle facing; 

/* thig is not really @ shape dezeriptor: Cand this ig the only place in the game whare You : - & 2 
find this pweudo-shopedeseripter type? the collection is valid, as uaueal, but the 


ghapa index Is an index ints tha animated shape array for that agilection, */ 
shape_descr iptor shape; 


word sequence; /* for shape animation */ 
word flags; /* luxwd.alot 1) tranderad. 1) fanimated 4) Cunwed.4) Linvisible, 1 faolid. 12 txtatue. 1) fowner. 3) #7 
short transferumode, transfer_period; /* if NONE take from shape data *; 

short transfer.phase; /* for trangfar moda animatiang 

short permutation; /* umualiy index into owner array ld 





short nextwobject; /* or NONE */ 
short parasitic.object; /* or NONE */ 


/* used when playing sounds */ 
, fixed sound.p! tech; 


* onnmewnnnn endpoint definition */ 





*define ENOPOINT.IS.SOLID<e> (<e>=>flagsé1> 
*define SETENDPOINT.SOLIDITY<e,#> €¢8 76 6@=> flags|=1>:<Cad=> flagske” (word) 1 >> 


*define ENDPOINT.1S..TRANSPARENT<@> (<a>-> flagst4 >q 
*define SET ENOPO INT TRANSPARENCY <a, s> 648 976 Ce d=> flage|™4>: (Cad=> flagske” (word >4 >> 


; Ci ee 





Source code from Marathon Infinity displayed in BBEdit. 
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